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Language Specifications 



The Disk Autocoder system is designed to simplify the 
programmer's task. Instead of coding program state- 
ments in machine language, he can write symbolic 
statements that comprise an Autocoder source pro- 
gram. The source program is input to an assembler 
program, which is supplied by ibm, that translates 
the source statements into machine language and 
produces an object program. 

The Disk Autocoder language includes the follow- 
ing significant features: 

• Mnemonic operation codes that are more easily 
remembered than the actual machine-language op- 
eration codes. 

• Symbolic operands that eliminate actual core- 
storage address assignment and reference. 

• Literal operands that eliminate prior definition of 
actual constants. 

• Area-definition statements that allocate core storage 
for constants and work areas. 

• Assembler-control statements that allow the pro- 
grammer to exercise some control over the assembly 
process. 

• A macro facility that eliminates repetitive coding of 
general routines. By writing a single instruction 
(macro instruction), the programmer can specify 
that a routine be extracted from the Autocoder 
library and incorporated in his program. 



Machine Requirements 

The Disk Autocoder system requires the following 
minimum machine configurations. 

ibm 1401 System 

4,000 positions of core storage 
High-Low-Equal Compare Feature 
One ibm 1311 Disk Storage Drive 
One ibm 1402 Card Read-Punch 
One ibm 1403 Printer 



ibm 1440 System 

4,000 positions of core storage 

One ibm 1301 Disk Storage or one ibm 1311 Disk Storage 

Drive 
One ibm 1442 Card Reader 
One IBM 1443 or 1403 Printer 

ibm 1460 System 

8,000 positions of core storage 

One ibm 1301 Disk Storage or one ibm 1311 Disk Storage 

Drive 
One ibm 1402 Card Read-Punch 
One ibm 1403 Printer 

The Autocoder System can utilize the following 
devices and features if available: 
ibm 1444 Card Punch 
ibm 1404 Printer 
Console Printer 

8,000, 12,000, or 16,000 positions of core storage 
Print Storage feature 
Direct Seek feature (for a library change only) 

The system on which the object program is to be 
executed must have: 

• A card reader or a disk unit to load the object pro- 
gram. 

• Sufficient core storage to contain the object program. 
If the object program requires more than the avail- 
able core storage, the program must be executed in 
sections (overlays) or the job must be divided into 
multiple runs. 

• The devices and special features specified in the 
object program. 

• The high-low-equal compare feature, if the mltpy 
macro, the divid macro, or the clear option (, C) of 
the da statement is in the program. 

Related Information 

One of the following SRL publications should be used 
in conjunction with the Autocoder language specifi- 
cations: 

System Operation Reference Manual for IBM 1401 
and 1460, Form A24-3067. 

System Operation Reference Manual for IBM 1440, 
Form A24-3116. 



Programming with Autocoder 



Source Program 

The source program consists of statements written in 
symbolic language. Disk Autocoder symbolic language 
permits the programmer to define areas, write in- 
structions, call in library routines, and exercise some 
control over assembler operations. 

The Disk Autocoder language includes a standard 
set of mnemonic operation codes for declarative, im- 
perative, and assembler control operations. 

The mnemonics used in imperative statements are 
more easily remembered than the machine-language 
operation codes because they are usually abbreviations 
for the actual instruction. For example: 



Instruction 

Multiply 

Clear word mark 



Mnemonic 

M 

CW 



Machine-Language 
Code 



n 



The mnemonics used in declarative and assembler 
control statements have no machine language equiv- 
alent. 

Source-program statements are written using mne- 
monic operation codes and the names given to data, 
instructions, and constants. Literals (actual data to be 
operated on during processing) can also be written in 
the instruction statements that use them. 

The information contained in Autocoder statements 
is divided into four categories: 

1. Area definition (declarative operations). The area- 
definition entries are used to assign sections of 
storage for fixed data (constants) that will be needed 
during processing, to set aside work areas, and to 
assign symbolic names to data, devices, and areas 
used in the program. 

2. Instructions (imperative operations). The instruc- 
tion entries state, symbolically, the operations to be 
performed by the object machine, add, subtract, 
read, and punch are examples of imperative opera- 
tions. 

3. Control Statements (assembler control operations). 
The disk Autocoder system permits the programmer 
to exercise some control over the assembly process. 
For example, the programmer can specify the be- 
ginning address of the object program and the 
core-storage capacity of the object machine. 

4. Macro Instructions (macro operations). Macro in- 
structions are used to call out standard sets of in- 
structions (routines) from the library that is stored 



on disk. During program assembly, the assembler 
can extract the routine associated with the macro 
instruction, tailor it to fit the program requirements, 
and insert it in the object program. 

Assembler 

The Autocoder Assembler Program operates under the 
direction of a System Control Program. The functions 
of this control program are to coordinate system func- 
tions and to handle input/output device assignments. 

The Autocoder Assembler is a multiphase program 
designed to translate Autocoder statements into ma- 
chine language. At assembly time, the source program 
is read into core storage from cards or disk. The 
System Control Program reads the Assembler Program 
into core storage from the disk unit that contains the 
Autocoder system. 

The first step in the translation process is performed 
by the macro-generator phases of the Assembler Pro- 
gram. These phases examine source-program macro 
instructions, extract the associated library routines, 
and generate Autocoder statements. 

The Assembler then analyzes all Autocoder state- 
ments during a diagnostic phase. A diagnostic listing 
of all invalid statements is printed if the user specifies 
the option in his control card for assembly (ctl card). 
A programmed halt occurs after the diagnostics have 
been printed. The user can make corrections and re- 
start the assembly, or he can continue processing. 

After the macro instructions have been processed 
and the Autocoder statements have been analyzed, the 
Assembler translates the Autocoder statements into a 
machine-language object program. The object pro- 
gram is punched into cards or written in disk storage, 
depending on the specifications in the user's control 
cards. 

Coding Sheet 

Disk Autocoder statements are written on a coding 
sheet that is designed to organize them into the for- 
mat required by the assembler. Figure 1 shows the 
Disk Autocoder free-form coding sheet. 

Although the assembler can process statements 
coded in 1401 Symbolic Programming System (sps) 
and 1440 Basic Autocoder lanuguages (see ENT— 
Enter New Coding Mode), this publication refers 
primarily to the coding of Disk Autocoder language. 
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Figure 1. Autocoder Coding Sheet 



Write all source-program statements and comments 
on the coding sheet. Column numbers on the sheet 
indicate the card-punching format for all the cards in 
the source deck. Punch each line of the coding sheet 
into a separate card. 

The function of each portion of the coding sheet is 
explained here. 



Page Number (Columns 7 and 2) 

Write the sequence number of the coding sheet in this 
field. These numbers should be arranged according to 
low-to-high collating sequence. Any character that is 
valid for ibm 1400 series systems can be used. Refer to 
the ibm character-code chart in the System Operation 
Reference Manual. 

Note: Do not use an asterisk in column 1. 



Line Number (Columns 3-5) 

Use this field to indicate the sequence of entries on 
the coding sheet. The units position of this field may 
be left blank. It can be used later to indicate the se- 
quence of inserts on a page. The five unumbered lines 
at the bottom of a page can contain these inserts. 

For example, number the first insert between lines 
02 and 03 "025". Number later inserts at that point so 
that they can precede or follow the first insert, as 
required. Numbers on the coding sheet need not be 
consecutive; but, when the source deck is used as in- 
put to the assembler, the cards should be in low-to- 
high collating sequence. 

Inserts can affect address adjustment. An insert may 
make it necessary to change the adjustment factor in 
other entries. See Address Adjustment. 



Label (Columns 6-15) 

A label can have as many as six alphameric (A-Z or 
1-9) characters, but the first character must be alpha- 
betic. Special characters and blanks must not be used 
within a label. 

The label usually starts in column six. See Define 
Constant with Word Mark for exception. Any subse- 
quent references to the labeled item must correspond 
to the name used in the label field of that particular 
item. 

Columns 13-15 are not checked. 

Operation (Columns 16-20) 

Write the mnemonic or machine-language operation 
code in this field. 

Operand (Columns 21-72) 

Two operands and a d-character may be written in 
this field. An operand designates a core-storage ad- 
dress, an input/output unit, or a constant to be de- 
fined. A d-character modifies an operation code. It is a 
single alphabetic, numeric, or special character. 

The operands and the d-character must be separ- 
ated by commas because the Disk Autocoder coding 
sheet is free-form (the operand and d-character fields 
are not fixed fields). 

Comments 

The programmer can include a remark anywhere in 
the operand field if he leaves at least two nOn-signifi- 
cant blank spaces between it and the operand. 

To include a whole line of information anywhere in 
the program, write a comments line that contains an 
asterisk in column 6 and the comment in columns 7-72. 
Columns 6-8 should not contain *1*. (*1* in columns 
6-8 will cause a diagnostic to falsely appear during 
assembly.) A punched card containing a comments 
line is called a comments card. The information 
punched in the comments card appears in the sym- 
bolic-program listing produced by the assembler, but 
it does not affect the object program in any way. 

Columns 73-75 are not checked. 

Identification (Columns 76-80) 

Write an identification name or number in this field to 
identify a program or program section (overlay). 
Punch the contents of this field into each card in the 
source deck. The identification appears on the sym- 
bolic-program listing but does not affect the object 
program in any way. 

Writing Autocoder Statements 

Three types of information can be specified in Auto- 
coder statements: labels, operation codes, and oper- 
ands. 



Labels 

Labels are descriptive terms selected to identify a 
specific area or instruction in a source-program state- 
ment. A label that suggests the meaning of the area 
or instruction makes coding easier. It also makes the 
program more easily understood by others. For ex- 
ample: 



Type of Statement 

Area Definition 
Instruction 



Meaning Label 

Withholding Tax WHTAX 
Update UPDATE 



When the assembler processes a source-program 
statement, it assigns an address and allocates storage 
for the instruction or defined area. If the statement has 
a label, the assembler equates the label to the assigned 
address. In this publication the assigned address is 
called the equivalent address. 

The equivalent address of the label for an instruction 
is the leftmost (high-order) core-storage position of the 
area the assembler has allocated for it. For example, 
an instruction whose label is entryg is located in core- 
storage locations 549-552. The equivalent address of 
entryc is then 549. 

The equivalent address of the label of an area- 
definition statement is usually the rightmost (low- 
order) core-storage position of the area the assembler 
has allocated for the constant or work area. (See 
DCW — Define Constant with Word Mark and DC — 
Define Constant (No Word Mark) for exceptions.) For 
example, in a dcw statement a constant whose label is 
rate is located in core-storage positions 420-424. The 
equivalent address of rate is then 424. 

During, processing the assembler maintains a table 
of labels and their equivalent addresses. 

If a label appears in any Autocoder statement, it 
may be written as an operand in any other Autocoder 
statement. During processing, the assembler substi- 
tutes the equivalent address of the label whenever the 
label appears as an operand in a source-program 
statement. Thus, the programmer refers symbolically 
to the equivalent address of the constant, work area, or 
instruction. 



Operation Codes 

Most Autocoder statements have operation codes. (See 
Subsequent DA Entries for an exception.) In impera- 
tive instruction statements they are machine-operation 
codes such as a (add), s (subtract), sd (seek disk), and 
p (punch). 

In area-definition statements they are commands to 
the assembler to allocate storage, such as dcw (Define 
a Constant with a Word Mark and da (Define Area). 
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In assembler-control statements, they are signals to 
the assembler such as org (begin or originate the 
program) and end (end the program). 

The appendix of this publication contains charts 
that list all valid mnemonic operation codes. 



Operands 

Use the operand portion of an Autocoder statement to 
specify: 

1. For instruction statements: the address of the data 
to be operated on or the input/output units to be 
operated, and the d-character modifier to the op- 
eration code, if required. 

(A list of all valid operand sequences is included 
in the Appendix.) 

2. For area-definition statements: the constant or area 
to be defined, or the address or input/output unit 
that is to be the equivalent of the label. 

3. For assembler-control operations: the address to 
be used in a particular assembler operation. 



Core-Storage Address Operands 

There are five types of address operands used in Auto- 
coder statements: symbolic, actual, asterisk, blank, 
and literal. 



Symbolic 

A symbolic operand refers to the equivalent address 
of an instruction or defined area. The symbolic oper- 
and must be the same as the label of the instruction 
or area-definition statement. Writing a symbolic oper- 
and in a statement that precedes the labeled statement 
is permitted. 

In Figure 2, entrya is used as a label for an add. 
instruction and as a symbolic operand in a branch 
instruction. Assume that the equivalent addresses of 
entrya, whtax, and deduct are 568, 701, and 905 
respectively. The assembled machine-language in- 
structions would be A. 701 905 and B 568. In a pro- 
gram using these instructions, whtax and deduct 
would be used as labels elsewhere in the program. 
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F.AI.T.*.y.A 



Actual 

The programmer may use an actual address as an 
operand in any Autocoder statement. This address is 
a one-to-five digit number within the range to 15999, 
and represents an actual core storage position. 

For example, to cause a word mark to be set in 
location 001 during execution of the object program, 
write in the source-program the instruction shown in 
Figure 3. Note that it is not necessary to write high- 
order zeros in an actual address written in Autocoder. 



Label 



_is.il 



Operation 



_Z_t2_. 



&£__ 



OPERAND 
__U Sfi 



Figure 3. Actual Address Operand 



Asterisk 



Writing an asterisk in an Autocoder statement directs 
the assembler to assign an address equivalent to the 
right-most (low-order) position of the area that the 
instruction or data will occupy in the object machine. 
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Figure 4. Asterisk Operand 

Figure 4 shows a routine designed to compare 
field- A to field-B, and to add 1 to a field named count 
if the result is unequal. Assume that the equivalent 
addresses of total and count are 459 and 711 re- 
spectively. The asterisk then refers to 465, which is 
the address of the low-order position of the seven- 
character assembled instruction and *— 6 refers to 459. 
The assembled instruction is A 459 711. When the 
instruction is executed, one is added to count because 
459 is the address of the operation code (a). In core 
storage, an a is composed of A- and B-zone bits and a 
1-bit; these zone bits form the standard plus sign, and 
do not change the addition of the numeric 1. Figure 
5 is a representation of the instruction in core storage 
during program execution. 



Character 


A 


4 


5 


9 


7 


1 


1 


Core Storage 
Location 


459 


460 


461 


462 


463 


464 


465 



Figure 2. Symbolic Operand 



Figure 5. Instruction in Core Storage 



Blank 

Blanks are valid in statements where no operand is 
needed, or when useful addresses are supplied by the 
chaining method. Chaining is explained in the System 
Operation Reference Manual. 

Literals 

A literal operand "is the actual data to be used when 
the instruction in which it appears is executed. The 
assembler stores the actual data (constant) with a 
word mark over the high-order position when it en- 
counters a ltorg, ex, or end assembler-control state- 
ment. The equivalent address of the stored constant 
is substituted for the literal operand when the instruc- 
tion is assembled. The programmer can address-adjust 
and/or index a literal. See Operands: Address-Adjust- 
ment and Indexing. 

Duplicate literals are assigned core-storage space 
only once per program or program section. When a 
literal is referred to, a program section means those 
source-program entries that precede a ltoeg, ex, or end 
assembler-control statement. 

Figure 6 shows literal operands and the constants 
produced for them. 



Lobal 



Operatic 



ionl 



OPERAND 
__43 3fi 



A. . . l-f,ro,j./.A/.o.*.x. . 



Type 

of 
Literal 


Literal 
Operand 


Stored 
Constant 


Numeric 


+ 10 


I? 


Alphameric 


©JANUARY 28, 1962@ 


JANUARY 28, 1962 


Area-Defining 


WORKAR#6 


bbbbbb 


Address Constant 


+CASH 


xxx (Equivalent 

~ Address of CASH) 



Figure 6. Literals 

Numeric Literals. A numeric literal must be made up 
of integers only (0-9) and must be preceded by a 
plus or minus sign. The sign is necessary because 
the assember uses it to distinguish numeric literals 
from actual addresses. The literal may be any 
length, provided that it is contained in the operand 
portion of one program card. The sign is stored in 
the same core-storage position as the units position 
of the numeric literal. 

Figure 7 shows how a numeric literal can be coded 
in an Autocoder imperative instruction. Assume that 
the literal (+10) is assigned storage locations 584 
and 585, and index is assigned an equivalent ad- 
dress of 682. The symbolic instruction causes the 
assembler to produce a machine-language instruc- 
tion (A 585 682) that adds +10 to the contents of 
index when the instruction is executed in the object 
program. 



Figure 7. Numeric Literal 

Alphameric Literals. An alphameric literal is one 
or more alphameric characters written between two 
@ symbols. Alphameric characters include numeric, 
alphabetic, and special characters (including 
blanks). Any combination of alphameric characters 
can be used within the two ©symbols, with the 
following restrictions: 

1. If the object program is to be punched into cards in 
the condensed-loader format, a word-separator character 
(0-5-8 punch) should not be the first character following 
the first @ symbol. 

2. If the object program is to be written on disk (coreload 
format), a group mark should not be the first character fol- 
lowing the first @ symbol. 

(Object-program formats are described in the 
publication : 

Autocoder (on Disk) Program Specifications and 
Operating Procedures, IBM 1401, 1440, and 1460, 
formC24-3259.) 

Only one alphameric literal is permitted in a co- 
ding-sheet line. One or more @ symbols can be 
included within an alphameric literal (between the 
two @ symbols enclosing the literal), but an @ 
symbol must not appear anywhere else in a line 
containing an alphameric literal. The assembler 
scans the contents of the card from the left for the 
first @ symbol and from the right for the second 
@ symbol. All characters between the two @ sym- 
bols are assumed by the assembler to be part of 
the literal. 

Figure 8 shows how to use an alphameric literal 
in an imperative instruction. Assume that during 
assembly the literal January 28, 1964 is assigned a 
storage area whose equivalent address is 906, and 
date is assigned 230. For this statement, the assem- 
bler produces a machine-language instruction (M 
906 230) that moves the literal January 28, 1964 to 
date. 
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Figure 8. Alphameric Literal 

Address-Constant Literals. An address-constant lit- 
eral is the label of an instruction, defined area, or 
constant preceded by a plus or a minus sign. A 
plus sign preceding the label indicates that the 
constant represented by the literal is the machine- 
address the assembler assigns to the label. A minus 
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sign preceding the label indicates that the constant 
represented by the literal is the 16,000's comple- 
ment of the machine-address assigned to the label. 
The address assigned to any label, except labels 
associated with area-defining literals, can be repre- 
sented as constants by address-constant literals. 
(Area-defining literals are described in the follow- 
ing section. ) 

When the assembler encounters an address- 
constant literal, it: 



1. Allocates a three-position area that will contain the equiv- 
alent address or its 16,000's complement at object-program 
execution time. (The equivalent address is a three-charac- 
ter machine-language address.) 

2. Assigns an address to the allocated area and equates the 
address-constant literal to the assigned address. 

Figure 9 shows two address-constant literals (+ 
cash and ■+- checks) used in a source program. It 
also shows the entries the assembler makes in the 
object program, and the results when the instruc- 
tions are executed by the object program. The pro- 
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SYMBOLS 


EQUIVALENT 
ADDRESSES 


ENTRY1 
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CASH 


600 


CHECKS 
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WORK 
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797 
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ADD. 
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LIT- 
ERALS 



Object program in core storage after it has been loaded 
into the object machine. 
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NOTE: Assume that before step A is executed, data will be moved into the 
CASH, CHECKS and WORK fields. 



PROGRAM STEP 
EXECUTED 



OPERATION 



CORE STORAGE 
BEFORE OPERATION 



CORE STORAGE 
AFTER OPERATION 



The address of CASH is moved 
to the A-address of B (ENTRY 
1 +3). 8 is thus modified. 



*i°i°i°hh 2 



M 6 00612 

T 1 ' ' *' ' ' 
401 404 



The contents of CASH are moved 
to WORK. 



(?) CASH 


(5) WORK 


9 1 6 1 9 ] 8 1 7 I 5 

1 1 III 1.1 


1 1 -4 1 1 1 

L=J 1 UJ L+J 



~® 



M 



9|6 9 I 8 7 5 96 9875 
1 1 t I- I I 1 — I L_t- 



The address of CHECKS is moved 
to the A-address of B (ENTRY 
1+3). B is again modified. 



M6006 12 
7 ' ' ' i 1 ' — L - 



401 



M 6 6 6 12 



Program branches back to execute 
B. 



NO CHANGE 



NO CHANGE 



The contents of CHECKS are 
moved to WORK. 



(?) CHECKS 


(g) work. 


6|0|7|8|9|2 


IE 


9 1 8 1 7 1 5 

I 1 1 L^J 



(?) CHECKS 


(g) work 


6 1 1 7 1 8 1 9 I 2 

L^J — l_l — 1 — L+J 


6 |0 7 1 8 1 9 1 2 

Lr^l — 1 — II lil 



Figure 9. Address-Constant Literals 
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grammer did not know what addresses would be as- 
signed to cash and checks when he wrote the 
source-program statements. He did, however, write 
two instructions (a and c) that move these addresses 
into instruction b (entry 1). The address-constant 
literals (+ cash and -f- checks) caused the assem- 
bler to allocate storage in the object machine for 
equivalent addresses of cash and checks and to 
substitute the addresses of the address-constant 
literals in instructions a and c. 

Autocoder permits the programmer to adjust an 
equivalent address. To use the adjusted equivalent 
address, code the address-constant literal as follows : 

1. Plus or minus sign. 

2. Period. 

3. Label whose equivalent address is to be adjusted. 

4. Adjustment factor (plus or minus any integer that will 
produce a number greater than zero, but less than the 
number of core-storage positions available in the object 
machine) and/or an index-register symbol. 

5. Period. 

Figure 10 shows an equivalent address that is 
modified by an adjustment factor. Assume that the 
equivalent address of total is 565. When the in- 
struction is executed 561 will be moved to the area 
whose label is sum. 



Lab* I Operation 
I* — £!* 12 U IA_ 



IM/LC. . \+..T.O.T.A.L-A.. r S.U.M . 



Figure 10. Adjusted Address-Constant Literal 

Figure 11 shows an equivalent address that is 
modified by an adjustment factor and the contents 
of an index register. Assume that the equivalent 
address of total is 565. The constant that will be 
adjusted is 565. The adjustment factor is —4. The 
16,000's complement of 561 is used because the 
address-constant literal contains a minus sign. 



Lobel lOperationl OPERAND 

1316 20 21 2S 50 }S 12 IS SSL 



HUC . \-»T.OTA.L.-,<1.+.X3.». y S.U.H 



Figure 11. Adjusted and Indexed Address-Constant Literal 

When the instruction is executed, DCI will be 
moved to the area whose label is sum. D3I is the 
machine language equivalent of 15,439 [16,000 — 
( 565 — 4 ) ] . The 3 becomes a C because A- and 
B-bits represent X3. See Indexing for a discussion of 
index registers. 

Area-Defining Literals. This literal is used to define an 
area of blanks equal to the number following the 



# symbol. The area may be referred to by using 
the label that precedes the # symbol. 

At object-program load time, the defined number 
of blanks will be loaded into storage with a word 
mark in the high-order position. 

For example, in the statement shown in Figure 
12 the area-defining literal is #5, which can be 
referred to as workar. Assume that the equivalent 
address of outar is 800. If the assembler assigns 
locations 896-900 to the label workar, then the as- 
sembled instruction will be: M 900 800. This in- 
struction will move the contents of workar to 
locations 796-800 when it is executed in the object 
program. 



I 



Label Operation 

(SiS 20 21 



OPERAND 
_«2 IS 82. 



M.LC. lWORKA.IHfSfO.U TAR 



Figure 12. Area-Defining Literal 

Note: If a source program consists of two or more 
sections, the label that precedes the # symbol can 
be used only in the program section that contains 
the area-defining literal. 



Address Adjustment 

It is not necessary to devise so many labels for a 
source program, if adjustment for addresses is speci- 
fied in the operand fields of Autocoder statements. To 
do this, write an integer preceded by a plus or minus 
sign immediately following the operand. The assem- 
bler then develops an equivalent address, plus or 
minus the adjustment factor, and inserts it into the 
assembled object-program statement in place of the 
address-adjusted operand. The adjustment factor can 
be any positive or negative integer that will produce 
an address greater than zero but less than the number 
of core-storage positions available in the object ma- 
chine. 

Figure 13 shows a symbolic operand with address 
adjustment. Assume that the statement whose label is 
last is assigned storage locations 404 through 407. The 
equivalent address of the label last is then 404, which 
is the position that the B operation code of the branch 
instruction will occupy in core storage when the object 
program is loaded. 



Label 

( IS 


Operation 

l« 20 


21 2S 


so 


15 


40 


OPERAND 

45 SO 


1 








1 


. .•. . 






1 
1 . . . 


. .». . 






1 . . . 


. .e. . 






tA5,r , i , , , 


ft , , , 


ft 


, , , t 



Figure 13. Address Adjustment 
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The assembler substitutes the address of last + 3 
(407) in place of the symbolic address-adjusted oper- 
and (last + 3) when the object program is assembled: 
H 407 .... B 000. 

When the object program is executed, the contents 
of the B-address register are transferred to positions 
405-407, so that the I-address of the branch instruction 
contains whatever was in the B-address register before 
the sbr instruction was encountered (B xxx). 

Figure 14 shows an address-adjusted literal oper- 
and. The first statement is an instruction that adds a 
literal (+100) to sum. The assembler allocates a 
three-position area in core storage to store this literal. 
Assume that the equivalent address of this literal is 
698, and sum has an equivalent address of 805. The 
assembled instruction is A 698 805. Later in the source 
program the same literal appears with address-adjust- 
ment. Because the literal has been previously assigned 
with an area whose address is 698, the address- 
adjusted literal +100—2 refers to 698—2 or 696. 
Thus, the assembled instruction, A_696 805, will add 1 
into sum when it is executed in the object program, 
because storage-location 696 contains the 1-portion of 
the literal +100. 



Label 

« IS 


Operation 

16 20 


OPERAND 

II 25 30 35 40 4S SO 


i 


A. . . . 


-t-.lQO.fS.UM 




. .• . . 






. .•. . 






. ,•. , 







A 


+.1.0.O.-.2. r 3.UM 



Figure 14. Address-Adjusted Literal 

Figure 15 shows an address-constant literal operand 
with address adjustment. Assume that the equivalent 
addresses of the literal (+accum) and total are 697 
and 734, respectively, and that the address-constant 
literal is 419 (equivalent address of accum). The as- 
sembled instruction is A 697 734. Later in the source 
program the same address-constant literal appears 
with address-adjustment. Because the literal has been 
previously assigned to an area whose address is 697, 
the address-adjusted literal +accum — 1 refers to 697 
—1 or 696. Thus, the assembled instruction, A. 696 
734, will add 41 into total when it is executed in the 
object program, because 696 is the address of the area 
that contains 41. The instruction does not affect the 
address-constant literal (419). 



Label 
c IS 


Operation 

16 20 


OPERAND 

21 25 SO 35 40 45 SO 


1 




fAC.CUMy.TO.TA/. 


] , , , 


. ,•. . 




! 


. .0. . 
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i 


• 





i,i. 


A , , , 


tAfffi,Mi-.l,»TATA^ 



Indexing 

If an object machine has the advanced-programming 
special feature (1401) or the indexing-and-store-address- 
register feature (1440 and 1460), the source program- 
mer can use the three 3-position index locations 
(registers) provided by the feature. The assigned core- 
storage addresses and index-register numbers are 
shown in Figure 16. 



Index 


Core- 


3 -character 


Tag bits in tens 


Location 


Storage 


Machine 


position of 




Locations 


address 


3 -character 
machine address 


1 


087-089 


089 


A-bit, No B-bit 


2 


092-094 


094 


B-Bit, No A-bit 


3 


097-099 


099 


A-bit, B-bit 



Figure 15. Address-Adjusted Literal 



Figure 16. Index Locations and Associated Tag Bits 

The primary use of index locations is to modify ad- 
dresses automatically by adding the contents of an 
index location to an address. The core-storage address 
of the A- and/or B-operand can be modified by the 
contents of any index location: 

1. Set a word mark in the high-order position of the 
index-register location before inserting the index 
factor. 

2. Use an add or move instruction to insert or change 
the index factor. The programmer can use a label, 
XI, X2, X3, or the actual machine address (89, 94, 
or 99) as the B-operand. If he uses a label he must 
first write an equ statement to assign a label to the 
index location. (See EQU— Equate.) 

Note: If an index factor is to be used for address modification 
the user should be sure that no zone bits appear in the ten: 
position of the factor, nor in the units position if the systen 
has 4000 or fewer positions of core storage. 

3. Write +X1, +X2, or +X3 after the operand that is 
to be indexed. XI, X2, and X3 represent index 
registers 1, 2, and 3, respectively. 

When the assembler encounters an indexed operand, 
it puts tag bits over the tens position of the 3-character 
machine address assigned to the operand to specify 
which index register is to be used. The bit combina- 
tions and the registers they specify are shown in 
Figure 16. 

The modfication of the A- and/or B-address occurs 
in their respective address registers. For instance, if 
the A-address is indexed, the indexing occurs in the 
A-address register. This means that the original in- 
struction in storage is in no way changed or modified. 
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The three index registers can be used as normal 
storage positions when not being used as index-register 
locations. 

Figure 17 shows an indexed imperative instruction 
that causes the contents of the location labeled total 
to be placed in an area labeled accum as modified by 
the contents of index-location 2. total is the label for 
locations 3101 and accum is the label for location 
140. The assembled machine-language instruction for 
this entry is: M A01 1MO. The M in the tens position 
of the B-address is a 4-bit and a B-bit. The B-bit is the 
tag for index-locaton 2. 



Label 
6 15 


Operation 
16 20 


OPERAND 

21 25 JO 35 40 45 50 


i 


MAC 


T.O.TAU r AC.CUM+.X2. 



Figure 17. Symbolic Operand with Indexing 



Symbolic Indexing 

Symbolic indexing is permitted in any statement that 
can have actual indexing, except in an equ statement 
or in a da statement. The name used can be as many 
as six letters or digits, but the first character must be a 
letter. 

The assembler first reserves the index location(s) 
referred to by actual addresses (XI, X2, and/or X3) in 
the source program. Later, unreserved index locations 
are assigned to the symbolic references in the order 
of occurrence in the source program. For example, if 
the statement shown in Figure 18 appears in a source 
program, indexa will be assigned to an unused index 
location. 



Label 



lf /vr/g r.c 



Operation 
isll6 20 21 



JA_ 



OPERAND 
__S3 28 



\f.l.E.LDA.+./,/<0.£.X.A.,F.I .e.t.OA . . 



Figure 18. Symbolic Indexing 



After all three index locations have been reserved, 
the assembler will not process any new symbolic 
reference. Instead, an error indication will print on the 
assembly listing. Because the assembler must control 
the assignment of index locations, a symbolic refer- 
ence to an index location cannot be equated by the 
use of an equ statement to an actual address of an 
index location. 

To insert or change the index factor, write an add or 
move instruction with the name of the index location 
as the B-operand. The name must not be used as a 
label elsewhere in the program. 



Address-Adjustment and Indexing 

Figure 19 shows an imperative instruction with ad- 
dress adjustment and indexing on a symbolic address. 
The assembler will subtract 12 from the address that 
was assigned the label total. The effective address of 
the A-operand is the sum of total — 12 plus the con- 
tents of index-location 1 at program-execution time. 
The assembled instruction (M ?Y9 140) will cause the 
contents of the effective address of total — 12 -+-X1 
to be placed in the location labeled accum (assuming 
again that total is the label for location 3101 and 
accum is the label for location 140 ) . The Y in the tens 
position of the A-address is an 8-bit and an A-bit. The 
A-bit is a tag for index location 1. 



Label 

6 15 


Operation 

16 20 


OPERAND 

21 25 50 35 40 45 50 




M.L.C. 


TO.r.AL.-.l.l+.-X.1. } A.CCUM 



Figure 19. Symbolic Operand with Address-Adjustment 
and Indexing 



Figure 20 shows examples of address-constant-literal 
adjustment and of address-constant-literal address ad- 
justment. Assume that the equivalent addresses of the 
address-constant literal (-)-tax or — tax) and addr are 
503 and 700, respectively, and that the address con- 
stant of tax is 123. (See Address-Constant Literals and 
Address Constants Defined by a DCW Statement.) 

Constant Operands 

Constant operands are defined by area-definition state- 
ments. See DC and DCW Statements. The assembler 
assigns an area in core storage in which the constant 
is stored at object-program load time. 

Input/Output Operands 

For operations involving disk storage, write the mne- 
monic operation code in the operation field and the 
symbolic disk-address control field in the operand field. 
For example, the statement shown in Figure 21 will be 
assembled M %F1 598 W if 598 is the equivalent 
address of output. 



Label 



Operation 
!Sll6 20 21 



_J5_ 



W.D. . . \O.U.T.P.U.r. 



Figure 21. Write Disk 

For operations involving magnetic tape, write the 
mnemonic operation code in the operations field and 
the number of the tape unit in the operand field. The 
programmer can specify the number of the tape unit 
in one of three ways: 

1. Write the actual address of the tape unit (%Ux) as 
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Type of Adjustment' 


Source Program Instruction 


Assembled 
Instruction 


Constant 
Moved to 
ADDR (700) 


Constant 
Stored in 
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Adjusting the address 
constant literal 
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Adjusting and indexing 
the address constant 
literal 
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Adjusting the 16,000's 
complement of the address 
constant literal 
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(15,878) 


H7H 
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Adjusting the address 
of the address constant 
literal 
















M 501 700 


1 


123 




Label 

6 


IS 


Operation 
16 20 


21 


zs 


30 35 


40 


OPERAND 

45 


1 
1 , . , 


M.LC. . 


+ . 


r.A.X.-.2 


. A.D.D.R. 










,,,,,,,,,.,,,.,,,,, 






Adjusting the address 
constant literal and 
the address of the 
address constant literal 
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Figure 20. Address-Constant Literals with Adjustment and Indexing 



the A-operand. The statement shown in Figure 22 
will be assembled M %U4 615 W if 615 is the 
equivalent address of output. 



of the high-order position of the print-line in the 
operand field. For example, the statement shown in 
Figure 24 will be assembled: M. % Yl 801 W if 801 is 
the equivalent address of printI. 



Label Operation 



OPERAND 
J& 15 30. 



WJ. \%U4.jO.U.T.P,U.T. . . 



Label 



Operation 



. . \W. . 



-1S_ 



P.&l.hlT.I 



Figure 22. Tape Instruction with Actual Address 

2. Assign a label to the actual address of the tape unit, 
and use it as the A-operand of the tape instruction. 
(See EQU— Equate.) 

3. Write the number of the tape unit in column 21 of 
the tape instruction. The assembled instruction for 
the statement shown in Figure 23 will cause a rec- 
ord to be written on tape-unit 4 using the data be- 
ginning in a storage area labeled output. 



Figure 24. Printer Operand 

For operands involving the 1442 card read-punch, 
write the mnemonic operation code in the operation 
field. Then write the number of the, unit (1 or 2), fol- 
lowed by a comma and the symbolic address of the 
high-order position of the I/O area. For example, M 
%G1 110 R will be the instruction assembled from 
the statement shown in Figure 25, if 110 is the equiva- 
lent address of input. 



Label 



Operation 
_!5!S i£Z. 



OPERAND 
_S3 32 



WT Uy.OUT.PUT. 



Figure 23. Write Tape 

For operations involving the 1443 printer, write W 
or WS in the operation field and the symbolic address 



Label 



Operation 
J2!S till. 



OPERAND 

_ia 3fi 



, ft NP.UT 



Figure 25. Reader Operand 

Refer to the Appendix for a list of the mnemonics 
and operands that can be used to specify input/output 
operations. 
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Statement Descriptions 

All Autocoder statements must be presented to the 
assembler program according to a special format. 
There are also rules and restrictions for writing the 
information in these statements. These requirements 
are necessary because the assembler needs and can 
handle only certain kinds of information from each 
type of Autocoder statement, and it must know where 
in the statement that information can be found. 

In this publication the Autocoder statement descrip- 
tions are presented in a format that: 

1. Describes the operation which the statement 
specifies. 

2. Shows how the statement is written by the pro- 
grammer. 

3. States the actions of the assembler during process- 
ing of the statement. 

4. Describes the effect of the statement on the object 
program. 

5. Shows an example of the statement. 



label field. He can refer to the constant by using the 
label as an operand elsewhere in the program. If 
the label starts in column 6, its equivalent address is 
the address of the low-order position of the con- 
stant in the object machine. If the label starts in 
column 7, its equivalent address is equal to the high- 
order position of the constant in the object machine. 
3. Writes the constant in the operand field beginning 
in column 21. A comma and a G immediately fol- 
lowing the constant inserts a group-mark with a 
word-mark after the constant. 

The assembler: 

1. Allocates a field in core storage that will be used at 
object-program load time to store the actual con- 
stant. 

2. Inserts the equivalent address of the label in the 
object program wherever the label is used as a 
symbolic operand in a source-program statement. 

Result: The constant with a high-order word mark is 
loaded with the object program. 



Declarative Statements 

Declarative statements are used to assign sections of 
storage for fixed data (constants) that will be needed 
during processing, to set aside work areas, and to 
assign symbolic names to data and devices used in the 
program. 

The six declarative operations are: 
Op Code Purpose 

DCW Define Constant with Word Mark 

DC Define Constant (No Word Mark) 

DS Define Symbol 

DSA Define Symbol Address 

DA Define Area 

EQU Equate 

DCW — Define Constant with Word Mark 

General Description. Use a dcw statement to enter a 
numeric, alphameric, blank, or address constant into 
core storage at object-program load time. 

The programmer: 

1. Writes dcw in the operation field. If more than 
one dcw statement is to be written in succession, 
the programmer needs to write the dcw operation 
code for the first dcw statement. The dcw operation 
code for the remaining statements of the group 
can be omitted, if desired* 



Numeric Constants 

A plus or minus sign may be written preceding an 
integer. A plus sign causes the assembler to store the 
constant with A- and B-bits over the units position; a 
minus sign stores a B-bit there. If the integer is un- 
signed, it will be stored as an unsigned field. 

The first non-numeric column in the operand field 
indicates that the preceding position contains the last 
digit in the constant. 

A constant may be as large as 51 digits with a sign, 
or 52 digits with no sign. 

Examples. Figures 26, 27, and 28 show the three types 
of numeric constants that can be defined in dcw 
statements. The labels tenI, ten2, and ten3 identify 
the constants. Thus, they can be used as operands to 
cause the equivalent addresses of +10, — 10, and 10 
to be inserted in the object program whenever tenI, 
ten2, and ten3 appear in operand fields of other 
entries in the source program. 



hr, g / q , ■ 



Label Operation 

IS||« 20 21 U_ 



OPERAND 
_!5 



\DCW \tl.Q . 



Figure 26. Numeric Constant with a Plus Value 



Label Operation 
1516 20 2 



\T££LZ- \Qfi.w. , l-./.o. 



Figure 27. Numeric Constant with a Minus Value 



Label 



Operation 
_!S!S 2J2i 



. \D.CW. \1D. 



OPERAND 
__S5 32 



2. May write a label, but not an actual address, in the Figure 28. Unsigned Numeric Constant 
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Alphameric Constants 

Place an @ symbol before and after the constant. As 
with alphameric literals, blanks and the @ symbol 
may appear between these @ symbols, but the @ 
symbol must not appear in a comment in the same 
line as the constant. 

Up to 50 valid characters can be written in an alpha- 
meric constant. Any combination of alphameric 
characters can be used, with the following restric- 
tions : 

1. If the object program is to be punched into cards 
in the condensed-loader format, a word-separator 
character (0-5-8 punch) should not be the first char- 
acter following the first of the two @ symbols en- 
closing the constant. 

2. If the object program is to be written on disk 
(coreload format), a group mark should not be the 
first character following the first of the two @ symbols 
enclosing the constant. 

A comma and a G following the alphameric constant 
cause the assembler to insert a group-mark with a 
word-mark after the constant. 

Example: Figure 29 shows how to define the alpha- 
meric constant, January 28, 1964 in a dcw state- 
ment. The assembler will insert the equivalent 
address of the constant in the object-program in- 
struction wherever date appears in the operand of 
another source-program entry. 



Label 



VJAT.E. 



Operation 



OPERAND 
_4S 32 



D.cw. \ejA.rt.UA/iy. 2.8.J /9.e.4@. 



Figure 29. Alphameric Constant 



Blank Constants 



Blank constants used in dcw statements are equivalent 
to area-defining literals in instructions. 

Write the # symbol and an integer in the operand 
field to indicate how many blank storage positions are 
needed in the area. The defined area can contain any 
number of blank positions. 

Example: Figure 30 shows how to define an Imposi- 
tion blank field using a dcw statement. The equiv- 
alent address of the 11-position field is inserted in 
the object program wherever blank appears as an 
operand in another source program statement. 



Label 


Operation 
16 20 


OPERAND 
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Figure 30. Blank Constant 



Address Constants 



A dcw statement can define the equivalent address of 
an instruction, defined area, or constant. 



Form C24- 3258-1 
Page Revised 6-1-65 
By TNL N21-0038-0 

In the operand field, write the label of the instruc- 
tion, area-definition, or constant, and precede the label 
with a plus or minus sign. If a minus sign is used, 
the constant defined is the 16,000's complement of the 
equivalent address of the label. 

Example. Figure 31 shows how an address constant 
(the equivalent address of manno) can be defined 
by a dcw statement. The address of the equivalent 
address of manno will be inserted into an object- 
program instruction wherever serial appears as the 
operand of another source-program entry. Thus, 
+ manno is the symbolic address of the field that 
contains the equivalent address of manno. 



SE.RI A.L 



Operatii 
I5ll6 2Q|2I 



_2S_ 



DCW \rfliA.N.N.n. 



Figure 31. Address Constant Defined by a dcw Statement 

Address constants can be adjusted and indexed. 
The adjustment and indexing refer to the address 
constant itself rather than to the address of the loca- 
tion of the address constant. If cash is the symbolic 
address of a field, the equivalent address of cash is 
indexed or address-adjusted rather than the equiv- 
alent address of -f- cash. 

Example. In Figure 32 the address constant (the 
equivalent address of cash) is 600. Whenever total 
appears as the operand of another source-program 
entry, it will represent the equivalent address of a 
location that contains 604 (the adjusted address con- 
stant of cash). (See Figure 20.) 

Note: —cash + 4 would refer to position 15,404 
(16,000-600 + 4). 



Label 



\ TPT A.k. 



Operation 



DCW 



■f-CASH.t.f. 



Figure 32. Adjusted Address-Constant Defined by a dcw 
Statement 



DC — Define Constant (No Word Mark) 

General Description: To load a constant without a 
high-order word mark, write a dc statement. The 
format of a dc statement is the same as that of a dcw 
statement. The dc operation code is used in the op- 
eration field. If more than one dc operation code is 
to be written in succession, the programmer needs 
to write the dc operation code for the first dc state- 
ment. The dc operation code for the remaining 
statements of the group can be omitted, if desired. 

Example: Figure 33 shows tenI defined as a constant 
without a word mark. 
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Label 



\T.EN.1. 



Operation 
'«'« 12.1L. 



\D^_ 



OPERAND 
_4S 



-1-1.0. 



Figure 33. Constant Defined by a dc Statement 

DS — Define Symbol 

General Description. Use a ds statement to label and 
skip over an area of core storage. With a ds state- 
ment, the bypassed area is undisturbed during the 
loading process. Thus, any information that was in 
storage before loading begins will still be there after 
the object program has been loaded. 

The programmer: 

1. Writes ds in the operation field. 

2. May write a label, but not an actual address, in the 
the label field. 

3. Writes a number in the operand field that tells the 
assembler how many positions of storage to bypass. 

The assembler: 

1. Assigns an equivalent address to the label. This 
equivalent address refers to the low-order position 
of the bypassed area. 

2. Inserts this address wherever the label appears as 
an operand in another source-program entry. 

Result. The positions included in the bypassed area 
remain undisturbed during object-program loading. 

Example. Figure 34 shows how to direct the assembler 
to bypass a 10-position core-storage area. Assume 
that the last core-storage position the assembler allo- 
cated before it encountered the ds statement was 
940. The equivalent address of accum is 950, the 
address of the low-order position of the core-storage 
area bypassed by the ds statement. Wherever accujm 
is used as an operand, 950 will be inserted in the 
object program. 



\AC.Cum Ads. . At. a 



Operation 
islie 20 1 1 



OPERAND 
_1S 



Figure 34. ds Statement 

DSA — Define Symbol Address 

General Description. The ability to code address con- 
stants in Autocoder language eliminates the need 
for the dsa statement except when the three-charac- 
ter machine address of an actual address in the 
source program is desired. The address constants 
previously discussed were created from labels. 

The programmer: 

1. Writes dsa in the operation field. 



2. May write as the label, the name that will be used 
to make reference to the address constant. 

3. Writes the actual or symbolic address to be defined 
in the operand field. This address may be address- 
adjusted and indexed, dsa with a symbolic operand 
is equivalent to a dcw address constant. 

The assembler: 

1. Produces a constant containing the equivalent ad- 
dress of the storage address written in the operand 
field. 

2. Assigns to this address constant an equivalent ad- 
dress in core storage and labels it using the name 
that appears in the label field. 

Result. At program-load time the address constant 
will be loaded into its assigned locations with a 
word mark in the high-order position. 

Example. Figure 35 shows how to develop and store 
an address constant for an actual address. 



Label 



lH / , * A/.X| 



Operation 
_!2!S___22JJ_ 



\£&L- 



OPERAND 
. 59 iS 



£24, 



Figure 35. Defining the Address Constant of an Actual 
Address 



DA — Define Area 

General Description. A da entry reserves and defines 
portions of core storage. Use a da entry to: 

1. Define one area, such as an input, output, or work 
area. 

2. Define several areas that have the same format. 

3. Define fields within the defined area. 

The complete da entry has two parts: the da header, 
which gives the assembler specific information on how 
to set up the area, and the subsequent da statements, 
which define the fields within the area. 



DA Header 

The programmer: 

1. Writes da in the operation field. 

2. Writes a label. The equivalent address of the label 
represents the high-order position of the entire area 
defined by the da header statement. 

3. Writes the first operand in the form B X L. B is 
the number of identical areas to be defined and L 
is the length of each area. 

4. May write a comma and the number of an index 
location (XI, X2, or X3) after the B X L entry. The 
indexing specified in the da header statement refers 
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to subsequent da entries. Tag bits will be over the 
tens position of the equivalent addresses wherever 
the labels of subsequent da entries appear as oper- 
ands in source-program instructions, unless the 
operand is indexed. The indexing in the operand 
overrides the indexing specified by the da header. 

Note: Symbolic indexing is not permitted in a 
da header statement. 

5. May write ,+ after the B X L entry to cause the 
assembler to insert a record mark without a word 
mark immediately after each area defined by the 
B X L entry. 

6. May write ,G after the B X L entry to cause the 
assembler to insert a group-mark with a word-mark 
immediately after the last area defined by the B 
X L entry. 

7. May write ,C to cause the assembler to clear the 
defined area(s) at object time before any word 
marks are set. 

Note: The ,+,G,C and, index-code entries may 
be written in any order after the B X L entry. 



Subsequent DA Entries 

The programmer: 

1. Leaves the operation field blank. 

2. May write a label. The equivalent address of the 
label represents the low-order position of the field 
or subfield with which it is associated. A subfield is 
a field within a defined area or field. 

3. Specifies- in the operand field the relative location 
of a field or subfield. The first position of each 
area defined by the da header statement is con- 
sidered location 1. 

a. To define a field, write the high-order and low-order 
position of the field (beginning in column 21). Separate 
the two numbers by a comma. To define a one-position 
field, write the relative location number twice. Word 
marks are set in the high-order positions of all defined 
fields. 

b. To specify the location of a subfield, write the number 
(beginning in column 21) that represents the relative 
location of the low-order position of the subfield. The 
location is relative to the first position of the area de- 
fined by the da header statement. No word marks are 
set in the low-order positions of subfields. 

A subfield can be located anywhere within the area 
defined in the da header statement. It does not have 
to be within a field defined by a subsequent da entry. 

4. May list fields and subfields in any order after the 
da header statement. All the fields within the area 
need not be defined. 



The assembler: 

1. Allocates an area which is equal in length to the 
total of B X L plus positions for record marks and 
a group-mark with a word-mark, if they have been 
specified in the da header. 

2. Assigns equivalent addresses to the da header label 
and to the labels of all defined fields and subfields. 

3. Inserts the equivalent address of the high-order 
position of the entire defined area wherever the 
label of the da header appears as an operand in the 
program. 

4. Inserts the equivalent addresses of the low-order 
positions of fields and subfields defined in the other 
da entries wherever their labels appear as operands 
in the program. 

Result. When the object program is loaded: 

1. The entire defined area is cleared if the da header 
statement contained a comma C. 

2. Word marks are set in the high-order position of 
all fields defined by subsequent da entries. A word 
mark is set in the high-order position of each area 
defined by the da header if a subsequent da entry 
is l,n. 

3. A group-mark with word-mark, and record marks 
are set if they have been specified by the da header. 

Example. Figure 36 shows a da header statement that 
defines four 100-position areas. If only one area is to 
be defined, write 1 X 100 as the first entry in the 
operand field. 



Label 

6 IS 


Operation 

16 20 


OPERAND 

21 23 30 SS 40 45 SO 




OA. , , 


4xi.oa 



Figure 36. da Header 

Example, inarea is defined by the da header shown 
in Figure 37. The second statement in Figure 37 
defines a field within inarea. Thui, the equivalent 
address of accum has a tag bit (A-bit) over the tens 
position to indicate that it is to be indexed by the 
contents of index-location 1. 



Label 

6 IS 


Operation 

16 20 


21 25 


so 


S5 


40 


OPERAND 

45 50 


IMAHE..^ . 


DA ■ ■ 


3X.&.O.J.X.1 


ACCUM ! . . , 




35.. Aft 



Figure 37. Indexing a da Entry 

However, an imperative statement elsewhere in 
the source program indicates that accum is to be 
modified by the contents of index-location 2. Be- 
cause the statement shown in Figure 38 contains 
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indexing, the assembler will tag the equivalent ad- 
dress of accum with a B-bit when it assembles the 
instruction for that statement. The indexing in the 
statement that uses accum as an operand overrides 
the indexing prescribed by the da header statement. 



Label 

6 19 


Operation 

16 20 


OPERAND 

21 29 30 33 40 43 SO 




2A . , 


Z.R.OSS.yA.C.C.UM+x.2. 



Figure 38. Overriding Previously Prescribed Indexing 

To negate the effect of indexing on a field or sub- 
field, put an XO in the operand field of each instruc- 
tion in which indexing is not wanted (Figure 39). 



Lobel 

6 IS 


Operation 

IS 20 


OPERAND 

21 23 SO 35 40 43 50 


i 
i . . . 


ZA , , 


SR.OSS. y A.C.CUM+.xo. 



Figure 39. Negating the Effect of Indexing 

Example. Figure 40 shows a da header statement that 
directs the assembler to insert a record mark after 
each of the areas defined and a group-mark with 
word-mark immediately after the last-defined area. 
The 2 X100 entry causes 200 positions to be re- 
served by the assembler. The ,+ and ,G entries 
cause 3 additional positions to be reserved as shown 
in Figure 41. 



Label 



UUTA . 



Operation 
ISllS 20 21 



J2A_ 



OPERAND 
_43 as 



\ZX,l.Q,QT*yG. 



•« 203 Positions •» 




f 




f# 


«* 100 Positions ^ 




«• 100 Positions »» 







Figure 41. Record Marks and a Group-Mark with a 
Word-Mark 



Example. A payroll record (Figure 42) is to be moved 
into an area of core storage. 

The card record is 80 positions, one for each 
column of the card. The significant fields to be de- 
fined in the record area are: 



■ 



Positions 


Label 


Description 


4-8 


MANNO 


Man Number 


11-26 


NAME 


Employee Name 


32-37 


DATE 


Date 


45-64 


GROSS 


Gross Wages 


66-71 


WHTAX 


Withholding Tax 


74-79 


FICA 


FICA Deduction 



Figure 40. da Header 



The remaining card columns contain data not 
needed for the operation. Positions 34 and 35, which 
indicate the month within the date, will be defined 
as a subfield. A group-mark with a word-mark is 
needed in the storage position immediately follow- 
ing the area. 

The da header shown in Figure 43 defines the area 
into which the record is to be moved. The 1 X 80 
entry causes the assembler to reserve 80 core-storage 
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DATE 
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/ 


NO 


DA 


M0 


YR 


V 




4 8 




II 26 




32 37 




45 I ' 



[ GROSS 




WHTAX 




FICA 






1 64 




66 71 




74 79 







Figure 42. Input Card 
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positions for the area. The ,G causes the assembler 
to set a group-mark with a word-mark in the 81st 
position of the area at program-load time. This area 
can then be referred to by using the name rdarea 
in the operand of another source-program entry. 
The equivalent address of rdarea will be the 3- 
chaiacter machine address of the high-order posi- 
tion of the entire area allocated by the assembler. 
The other da entries shown in Figure 43 define the 
fields and subfields within the record. 
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• 15 
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It 20 


OPERAND 

II XS SO SJ 40 43 SO 
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. . . 



Figure 43. da Entry 

In the source program, an instruction to move 
the record into a storage area labeled rdarea will 
cause the data in the record to be stored in the 
appropriate fields. Source-program statements may 
then be written to manipulate this data, using the 
labels as operands. The word marks set at program- 
load time will stop the transfer of data when indi- 
vidual fields are moved, added, etc. 

EQU — Equate 

General Description: Use an equ statement to assign 
a label to an actual, asterisk, or symbolic address, 
or to a control field or an index location. More than 
one label can be assigned to represent the same 
storage location. 

The programmer: 

1. Writes equ in the operation field. 

2. Writes a label. 

3. Writes an actual, asterisk, or symbolic address in 

the operand field. 

Note: XI, X2, and X3 should not be used as labels of equ 
statements, because the assembler assumes that they are equated 
to 089, 094, and 099, respectively. Further, a label must not 
be equated to a literal, because the assembler considers such 
a label as being undefined. 

The assembler: 

1. Assigns to the label of the equ statement the same 
equivalent address that was assigned to the name 
in the operand field (with appropriate alteration if 
indexing and address adjustments are indicated). 

2. Inserts this equivalent address wherever the label 
of the equ statement appears as an operand. 

Result: Either the label or the operand of the equ 
statement can be used to refer to the same core- 
storage location. 



Examples: Figure 44 shows how to assign another 
label (indiv) to a location which was previously 
labeled manno. The equ statement causes the as- 
sembler to assign the same equivalent address (1976) 
to indiv that it previously assigned to manno. Now, 
whenever either manno or indiv appears as an 
operand, the assembler will replace the operand 
with 1976. 



Label 



\IAI.QI.V. ■ 



Operation 
'*K IflUL 



_is_ 



OPERAND 



\E.QU. 1MAM.N.O. 



Figure 44. Equating Two Symbolic Addresses 

Figure 45 shows a statement equating the equiv- 
alent address of fica — 10 to whtax. If the assembler 
assigns fica an equivalent address of 890, the whtax 
will be assigned an equivalent address of 880, 
which is also equal to fica — 10. whtax now refers 
to a field whose units position is 880. 



Label 



MHTA*. i 



Operation 
'«'« 22 ti_ 



Eftf, 



OPERAND 
Si 39. 



\F,f,CA,-.ia 



Figure 45. Equating a Symbolic Address to an Address- 
Adjusted Symbolic Address 



Figure 46 shows how to equate a label to an actual 
address. Assume that a certain field will be in a 
storage location whose units position is known to be 
at actual-address 319. The programmer wishes to 
refer to this field as adda, but it has not been labeled 
elsewhere in the program. To equate the label adda 
to 319, write the statement shown in Figure 46. 
Thus, 319 becomes the equivalent address of adda. 



Label 

6 IS 


Operation 
16 20 


OPERAND 

21 25 SO SS 40 4S SO 


AUDA. . ! . . . 


EQU. 


3.'S 



Figure 46. Equating a Label to an Actual Address 

Figure 47 shows how to index an operand in an 
equ statement. With indexing, the label of the equ 
statement is indexed by the same index location that 
is specified in the operand field of that equ state- 
ment. However, if the label appears in the operand 
field of another source-program entry with another 
index code, the new code overrides the index code 
in the equ statement. 



Label 



IC. US.TA.fl, 



Operation 
>m 22 ti 



-iSL 



OPERAND 
_«2 52 



E.O.U lJQfl+X3. 



Figure 47. Indexing an equ Statement 
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For example, in the statement shown in Figure 
47 the equivalent address of job wth the tag bits of 
index-location 3 is assigned to the label custno. 
Thus, if job-[-X3 is equal to 5H5, custno also has 
5H5 as its equivalent address. However, if custno+ 
XI, custno+X2, or custno+XO appears as the 
operand of another source-program entry, the ad- 
dress inserted in its place will be 5Y5, 5Q5, or 585, 
which specifies index-location 1, 2, or none, respec- 
tively. 

Figure 48 shows how to assign a label to an 
asterisk in an equ statement. The * refers to the 
last storage location the assembler assigned before 
it encountered the equ statement. Assume that this 
address is 698. fielda has an equivalent address of 
698. 



Label 



\F./.FL.AA, 



Operation 
JS!S iSli. 



E.O.U. 



OPERAND 
—43 3fi 



H E 



Figure 48. equ Statement with an Asterisk Operand 

Figure 49 shows how to assign a label to an index 
location. Because the actual core-storage address of 
index-location 1 is 089, the equ statement assigns 
the label indexI to that location. 



Label 

6 IS 


Operation 

16 20 


Zl 


2S 


30 


3S 


40 


OPERAND 

45 SO 
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Figure 49. Equating a Label to an Index Location 

Figure 50 shows how to assign a label to the 
card-reader number 1 whose actual address is % Gi- 
lt is now possible to refer to this device as inputI. 



Label 



Operation 
_!2!2 Zfiii 



I.N.PU.T.ll . . E.Q.U. l%6.». . . . 



OPERAND 



Figure 50. Equating a Symbolic Address to an I/O Device 



Imperative Statements 

General Description. These are the symbolic instruc- 
tions for the commands to be executed in the object 
computer. A source program will probably contain 
more of these imperative instructions than any other 
type of Autocoder statement. 

The programmer: 

1. Writes the mnemonic operation code for the in- 
struction in the operation field. 



2. Writes the operand(s) in the operand field. The 
first operand is the A- or I-operand; the second is 
the B-operand. A- and B-operands are literals or 
addresses of data fields. An A-operand can also be 
an input/output operand. An I-operand is the ad- 
dress of an instruction. If a d-character is required, 
it must be written at the immediate right of the 
operands. 

All items in the operand field must be separated 
by commas. 

Note: Several mnemonic operation codes have 
been developed which cause the d-character to be 
supplied automatically by the assembler. However, 
some operation codes (for example, bin) have so 
many valid d-characters that it is impractical to 
provide a separate mnemonic for each. For these 
operation codes, the programmer must supply the 
d-character. In the listing of mnemonic operation 
codes for imperative instructions (Appendix), all 
mnemonics that require a d-character in the oper- 
and field are indicated by two asterisks. 

3. If the instruction is to be referenced, the program- 
mer can label such an instruction. The label will 
have an equivalent address that is the storage lo- 
cation that will hold the operation code of the 
associated instruction when the object program is 
loaded. Thus, the label can be used as the I-operand 
of a branch instruction elsewhere in the program. 
(See Figure 51). 

The assembler: 

1. Substitutes the actual machine-language operation 
code for the mnemonic in the operation field. 

2. Substitutes the 3-character equivalent machine ad- 
dress of the operands to indicate the A/I or B- 
address of the instructions. 

If address-adjustment or indexing codes are writ- 
ten with these operands, the appropriate alteration 
will be made for these addresses. Tag bits will be 
inserted in the tens position of indexed operands. 
Address-adjusted operands will be modified by 
adding or subtracting the adjustment factor. The 
assembler will supply the d-character for unique 
mnemonics, or place in the instruction the d-char- 
acter from the operand field of the Autocoder state- 
ment if the programmer has supplied it. 

3. Assigns to the actual-machine-language instruction 
an area in object core storage. The address of this 
area is the storage location the operation code will 
occupy when it is loaded into the object machine at 
program-load time. This address is the equivalent 
address of the label if one appears in the label field 
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of the source-program statement that contains the 
instruction. 



instruction causes a branch to ovflo. The assembled 
instruction is B 896 Z. 



Result. The instruction is loaded with a word mark 
in the high-order position. 

Examples. Figure 51 shows an imperative instruction 
with an I-operand. When the instruction is executed 
in the object program, a branch to the instruction 
whose label is start will occur. Assume that start 
has an equivalent address of 360. The instruction 
will be assembled B 360. 



Label 



Operation 
_!2« !2 SL- 



OPE RAND 
_4S 52 



IB . . . \STAJIT. 



Figure 51. Unconditional Branch with a Symbolic I-Operand 



Figure 52 shows an imperative instruction with 
A- and B-operands. This instruction, when executed, 
causes the contents of accum to be added to the 
contents of total. Assume that the equivalent ad- 
dresses of accum and total are 495 and 520, re- 
spectively. The assembled machine-language in- 
struction is A 495 520. 



Label 



Operatic 
J5!S 2fitti_ 



OPERAND 
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Figure 52. add Instruction 

Figure 53 shows an imperative instruction with 
I- and B-operands and a mnemonic (bce), which 
requires that the programmer supply the d-character 
(5) in the operand. When this instruction is executed 
in the object program, a branch to the instruction 
whose label is read will occur if the location la- 
beled test contains a 5. Assume that the equivalent 
address of read is 596 and test is 782. The assem- 
bled instruction is B 596 782 5. 
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Figure 54. branch if arithmetic overflow 

CU, LU, and MU Mnemonics 

These mnemonics permit the programmer to code in- 
structions for systems equipped with special features 
and devices that are not otherwise provided for in this 
Autocoder. 

CU- Control Unit 
The programmer: 

1. Writes cu in the operation field. 

2. Writes the address of the unit in the operand field 
in the format %Xn, d. A symbolic operand may be 
used to represent the address of the unit, if that 
symbolic operand has been defined by an equ state- 
ment elsewhere in the source program. 

The assembler: Provides a five-character instruction 
with the operation code U. 



LU-Load Unit 
The programmer: 

1. Writes lu in the operation field. 

2. Writes the address of the unit in the operand field 
in the format %Xn, BBB, d. A symbolic operand 
may be used to represent the address of the unit, 
if that symbolic operand has been defined by an 
equ statement elsewhere in the source program. 

The assembler: Provides an eight-character instruction 
with the operation code L. 
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Figure 53. branch if character equal 



Figure 54 shows an imperative instruction with 
a unique mnemonic (bav). The assembler supplies 
the d-character (Z) for this instruction when it is 
assembled. Assume that ovflo is assigned an equiv- 
alent address of 896. If, when the program is exe- 
cuted, an arithmetic overflow occurs, the first 



MU — Move Unit 
The programmer: 

1. Writes mu in the operation field. 

2. Writes the address of the unit in the operand field 
in the format %Xn, BBB, d. A symbolic operand 
may be used to represent the address of the unit, 
if that symbolic operand has been defined by an 
equ statement elsewhere in the source program. 

The assembler: Provides an eight-character instruc- 
tion with the operation code M. 
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Machine Language Coding 

Autocoder permits the programmer to use actual 
machine-language operation codes and d-characters. 

The programmer: 

1. Writes in column 19 the actual machine-language 
operation code for the instruction. Columns 16, 17, 
and 18 must be left blank. 

2. Writes in column 20 the d-character in machine 
language. If no d-character is required, column 20 
must be left blank. 

3. May write a label in the label field. 

4. Writes an actual, symbolic, blank, or asterisk ad- 
dress in the operand field. The operand field must 
not contain the d-character. 

The actual address of an input/output unit must 
be used unless a label has been assigned to the unit 
in an equ statement. 

Example. Figure 55 shows machine-language coding 
for an operation involving the ibm 1012 Tape Punch. 
Figure 55 also shows the same instruction coded in 
Autocoder. Either statement will cause the assem- 
bler to produce the instruction: M %P1 754 W if 
the equivalent address of label is 754. 
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Figure 55. ibm 1012 Tape Punch Instructions 



Assembler Control Statements 

These are the Autocoder statements that permit the 
programmer to exercise some control over the assem- 
bly process: 



Operation Code 


Purpose 


JOB 


Job Card 


CTL 


Control Card 


ORG 


Origin Assembly 


LTORG 


Literal Origin 


EX 


Execute 


XFR 


Transfer 


END 


End Assembly 


SFX 


Suffix 


ULST 


Stop Listing 


LIST 


Start Listing 


SPCE 


Space n Lines 


SKIPN 


Skip to next page 



JOB — Job Card 

General Description. This card tells the assembler 
how to identify the program in the output listing 
from the assembly process. It also identifies the 
object program. 

The programmer: 

1. Writes job in the operation field. 

2. Writes in the operand field the indicative informa- 
tion to be printed in the heading line of the output 
listing. Any combination of valid characters may be 
written in this statement (within columns 21-72). 

3. Writes in the identification field (columns 76-80) 
the identification name or number that refers to 
the program. 

The assembler: 

1. Prints the information contained in the operand 
field of the job card, the identification number, and 
a page number in the heading line of each page of 
the output listing. If the source deck does not con- 
tain a job card, the assembler prints only the page 
number. 

2. Punches the identification number in columns 76-80 
of all condensed cards it produces for the object 
program. 

3. If several job cards appear in the source deck, the 
assembler changes the information in the heading 
line and in the object program to reflect the new 
job identification. A new job card also causes the 
printer carriage to restore so that the new job or 
program starts on a new page of the output listing. 

Result: Different programs or program overlays are 
easily identified in the output listing. 

Example: Figure 56 shows a job card prepared for a 
program identified as employee payboll begister. 
It is identified in the object program as prlrg. 
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Figure 56. job Card 



CTL — Control Card for Assembly 

General Description: The ctl card describes the con- 
figuration of the object machine and specifies 
whether or not the cross reference listing, label 
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table, and diagnostic messages are to be printed. 
The cross reference listing shows each label, its 
core storage address, and the sequence numbers 
of each line on the program listing that refers to 
it. The label table lists all labels and their core stor- 



age addresses; the diagnostic messages list the in- 
valid source statements and the reasons for their 
invalidity. 

The format of the ctl card is shown in Figure 57. 
The ctl card may be partially punched or omitted. 



Columns 


Indicates 


Punch (Meaning) 


Assumptions If the Columns Are Left Blank 


16-18 


Mnemonic operation code 


CTL 




21 


Object machine size 


1 (4K) 

2 (8K) 

3 (12K) 

4 (16K) 


4K 


22 


Modify address feature available 


1 (yes) 


No, if the object machine has 4K; 

Yes, if the object machine has 8, 12, or 16K . 


23 


Advanced programming or indexing and store 
address register feature available 


1 (yes) 


No 


24 


Multiply-divide feature available 


1 (yes) 


No 


25 


Object machine 


(1401) 
4 (1440) 
6 (1460) 


Processor machine 


26 


Punch device 


S (1442, 1444) 
P (1402) 


S if the object machine is a 1440; 

P if the object machine is a 1401 or 1460 


27 


Read device 


S (1442) 
P (1402) 


S if the object machine is a 1440; 

P if the object machine is a 1401 or 1460 


28 


* Print device 


S (1443) 
P (1403) 


S if the object machine is a 1440; 

P if the object machine is a 1401 or 1460 


29 


Disk device 


1 (1311, 1301) 

2 (1405) 


1311 or 1301 


30 


Source Statement Diagnostics 


1 (yes) 
N (no) 


Yes 


31 


Label Table or Cross Reference Listing 


L (Label Table) 
N (neither) 


Cross Reference Listing 


32-36 


** Object deck in ihe self-loading format, or 

Read-in area for a 1 440 object deck in the 
condensed-loader format. 


Sbbbb 

5 digit starting address 


Object deck in the condensed-loader for- 
mat with the read-in area starting at 00001 . 


37-41 


Loader location (These columns are not 
checked if column 32 contains an S.) 


5 digit starting address. 

If column 42 contains a 

D, punch: 

03701 (4K) 

07701 (8K) 

11701 (12K) 

15701 (16K) 


00075 if the object machine is a 1440; 
00081 if the object machine is a 1401 or 1460 


42 


Disk Loader (for object programs in the 
core load format) 


D (yes) 


No 



* Consider a 1403 printer attached to a 1440 system as being the same as a 1443 printer. 

** Object -program formats are described in Autocoder (on Disk) Program Specifications and Operating 
Procedures for IBM 1401, 1440, and 1460, Form C24-3259. 

Figure 57. ctl Card Format 
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The figure shows the assumptions made by the 
assembler when columns are left blank. These as- 
sumptions are also made if the ctl card is omitted. 
If the ctl card is used, it must contain ctl in col- 
umns 16-18. 

Notes: 

1. The modify-address feature is standard on all ibm 
systems equipped with more than 4,000 positions 
of core storage. 

2. Column 42 should contain a D if the object pro- 
gram is to be placed on disk in the coreload for- 
mat. This will result from any of the following 
processor jobs: 

a. autocoder run thru execution (load and go) 

b. autocoder run thru output (conventional as- 
sembly) with a coreload optn 

c. output run thru execution (partial process- 
ing) 

d. output run (partial processing) with a core- 
load optn 

3. If an object program in the condensed loader 
format is desired in addition to or in place of one 
in the coreload format, the card loader begins at 
the position specified in columns 37-41. 

4. The only statements that may be placed between 
run and ctl cards are a job card and comments 
cards. 

ORG — Origin 

General Description: Use an origin card to tell the 
assembler the address at which to begin allocating 
storage for the program or for a particular part of 
the program (program overlay). An org statement 
may be included anywhere in the source program 
(except within a da entry). If no org statement pre- 
cedes the first entry in the source program, the as- 
sembler automatically begins allocating storage lo- 
cations, starting at address 334 for 1401 and 1460 
systems, and at address 210 for 1440 systems. 

The programmer: 

1. Writes org in the operation field. 

2. Writes a symbolic, actual, blank, or asterisk ad- 
dress in the operand field. This address indicates 
the next storage location to be assigned by the as- 
sembler. Symbolic, actual, or asterisk addresses can 
have address adjustment. An operand in an org 

I statement cannot be indexed and must be greater 
' than zero. 

3. If a symbolic address is used in the operand field of 
an org statement, its corresponding label must be 
defined ahead of it in the symbolic program. 

The assembler: assigns addresses to instructions, con- 
stants, and work areas beginning at the address 
specified in the operand field of the org statement. 



If the assembler encounters an org statement 
anywhere in the source program, it begins allo- 
cating storage for subsequent entries beginning at 
the address specified in the operand field of the 
new org statement. 

Result: The programmer can choose the area(s) of 
core storage where the object program will be lo- 
cated. 

Examples: Figure 58 shows an org statement with an 
actual address. 



Label 



Operation 
22 



VRG. . 



U JS_ 



OPERAND 
_SS S2 



SPA 



Figure 58. org Statement with an Actual Address 

The assembler will assign storage to the first 
source-program entry following this org statement 
with storage-location 500 as a reference point. This 
means that if the first entry following the org state- 
ment is an instruction, the Op-code position of that 
instruction will be 500. If the first entry is a 5- 
character dcw, it will be assigned address 504. 

The org statement in Figure 59 shows how to 
instruct the assembler to save the address of the last 
storage location allocated. This org statement causes 
the assembler to equate the label to the address, 
plus 1, of the last storage location assigned before 
the org statement. The assembler continues assign- 
ing addresses beginning at the equivalent address 
of start. 



Label 



Operation 
_!S!S JfiiL 



OPERAND 

_sa ss 



KDnri \OAG \STA.*T. 

Figure 59. Saving the Address of the Last Storage Allocation 

Another org statement may be used later in the 
source program to direct the processor to begin 
assigning storage locations at addr (Figure 60). 



Label 



J2!i 



Operation 



, Y>m, , Iaj>,p,/?, ■ 



_is_ 



OPERAND 
_4S Sfi. 



Figure 60. org Statement with a Symbolic Address 

Figure 60 shows an org statement that directs the 
assembler to start assigning addresses with the ac- 
tual address assigned to addr. 

When the assembler encounters the statement 
shown in Figure 61, it will begin assigning addresses 
to subsequent entries in the source program at the 
next available storage location whose address is a 
multiple of 100. For example, if the last address 
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assigned was 525, the next instruction (if the next 
entry is an instruction) will have an address of 600. 
It is possible to use additional address-adjustment 
factors with X00. For example, ORG *+X00— 9 will 
give an address of 591. 



Label 



Operation 



CL&&- 



_UL 



OPERAND 

_sa as 



l*.+.x.an 



Figure 61. Adjustment to Next Available Century Block 



If the object machine has an ibm. 1443 Printer and 
does not have the print storage special feature, the 
print area must begin in a hundreds +1 core storage 
position (101, 201, 301, etc.). Such a print area can be 
defined by an org statement with an operand of 
*+X00+l, followed by a da statement (Figure 62). 



LTORG — Literal Origin 

General Description: The programmer codes ltorg 
statements in the same way as org statements. A 
ltorg statement directs the assembler to begin as- 
signing storage locations to literals, address con- 
stants, and closed library routines (see Macro Sys- 
tem), which have been written ahead of the ltorg 
statement in the source program. The address of the 
storage location, which is the first to be allocated 
for a literal or closed library routine, is written in 
the operand field of a ltorg statement. A ltorg 
statement may be included anywhere in the source 
program. 

If the assembler does not find a ltorg statement 
in the source program, it begins literal origin after 
finding an ex or end statement. 

Example: Figure 64 shows how to direct the assembler 
to begin assigning storage locations to literals and 
closed library routines. 



Label 

6 IS 


Operation 
16 20 


21 25 


so 


ss 


40 


OPERAND 
«s so 


1 


r>R.Q. . 


*+.x.oo.+.l 


PAIMT.A 


DA. . . 


/ X./J20...6 , . . , 



Figure 62. Defining a Print Area 



Note: +X00 is permitted as an adjustment factor 
only when it is used with an asterisk, and it may be 
used only in an org or ltorg statement. 

Figure 63 shows an org statement with an asterisk 
and an address-adjustment factor in the operand 
field. The asterisk represents the address, plus one, 
of the last storage position assigned by the assem- 
bler. If the last address assigned was 525, the assem- 
bler will start assigning addresses at 591 (526 + 
65). 



Label Operation 
II _, !S!S 12 U U_ 



. . \0.g.6. Itt-trA.T . 



OPERAND 
_«2 IS SS 



Figure 63. org Statement with an Address-Adjusted 
Asterisk Operand 



An org statement with a blank operand field may 
be used. It will cause the assembler to start assign- 
ing addresses beginning with the first address (be- 
yond 333) after the highest address already assigned 
to other entries. 



Label 
6 IS 


Operation 
IS 20 


OPERAND 

CI 25 30 IS 40 45 SO 


i . . . 


ORG. 


5O.0 


W.K.A.RI.a\ . . 


O.C.W. 


**. 


C.A.L.C. . ! . . 


E.Q.U. 


1S.0.O 




ZA. . . 


+.1.0. y YI,K.A.R.E.A 


; 


I.NC.L.D 


S.U.B.O.l 


i 


B . 


S.U.B.O.l 


A.D.D.R. . ! . . . 


L.TO.R3 


CA.L.C 




ORG. . 


A.D.D.R 


F./.S.LD.A. . 


D.C.W. 


if. 6. 


F.I.E.LD.& . 


D.C.W. . 


*.s. 




ZA 


FJ.£.L.O.A.,.F.I.E.L.0.B. 



Figure 64. Using a ltorg Statement 



The programmer has instructed the assembler to 
begin storage allocation at 500. All instructions, 
constants, and work areas (ending with B SUB01) 
will be assigned storage. However, the literal (+10) 
in the statement ZA +10 wkarea, and the library 
routine (subOI) extracted by the incld macro (see 
INCLD), will not be assigned storage until the 
ltorg statement is encountered. The first instruction 
in the library routine (SUBOI) will be assigned ad- 
dress 1500 (V00) because calc has been equated to 
1500. 

After all instructions in SUB01 have been assigned 
storage locations, the literal +10 will be assigned 
an address. The assembler will begin assigning the 
rest of the instructions, constants, and work areas 
with the storage location immediately following the 
area occupied by the instruction B SUBOI. Thus, 
if a B SUB01 (B V00) is assigned locations 591-594, 
fielda will be assigned storage locations 595-600. 



27 



EX — Execute 

General Description: An ex statement makes it possi- 
ble to interrupt the object-program-loading process 
temporarily so that the part of the program that has 
already been loaded can be executed. 

The programmer: 

1. Writes ex in the operation field. 

2. Writes a symbolic operand. This must be identical 
to the label used for the first instruction to be 
executed after the loading process has been halted. 

The assembler: 

1. Assembles an unconditional-branch instruction for 
1440 systems and, if the self-loading format is 
specified, for 1401 and 1460 systems. A clear-and-; 
branch instruction is assembled for 1401 and 1460 
systems if the condensed-loader format is speci- 
fied. The I-address of the instruction assembled 
is the equivalent address of the first instruction to 
be executed after the loading process has been 
halted. This instruction does not become part of 
the object program. However, it is used by the 
loading routine to transfer control to the object 
program. 

2. Causes literals and closed library routines that have 
previously been encountered to be included at this 
point in the object program. 

Note: To continue the loading process after the 
program overlay has been executed, the programmer 
must provide re-entry to the load routine by writing 
the appropriate instruction(s) before the ex state- 
ment. The instructions are: 

A. 1401-1460 condensed-loader format. Branch to the start- 
ing address of the loader. If the loader has not been re- 
located (ctl card), the starting address is 081. 

B. 1440 condensed-loader format. Branch to the starting 
address of the loader, plus eight. If the loader has not 
been relocated (ctl card), the starting address is 075. 

C. 1401-1460 self-loading format. If the read-in area has 
not been disturbed during execution of the program over- 
lay, read a card and branch to 040 ( 1040 ) . 

If the read-in area has been disturbed: 

1. Clear the read-in area. 

2. Set word marks in 001, 040, 047, 054, 061, and 068. 

3. Read a card and branch to 040. 

D. 1440 self-loading format. If the read-in area has not 
been disturbed during the program overlay, branch to 
073. If the read-in area has been disturbed: 

1. Clear the read-in area. 

2. Set word marks in 001, 040, 047, 054, 061, 068, 072, 
073, 081, and 085. 

3. Positions 72-84 must contain j=M%G1001RB040. 

4. Branch to 073. 

E. 1401-1440-1460 coreload format. Use the LDRCL macro. 
See Linkage Macros. 



All object program formats are described in Auto- 
coder (on Disk) Program Specifications and Operat- 
ing Procedures for IBM 1401, 144V, and 1460, Form 
C24-3259. 

Example. Figure 65 shows how an ex statement can be 
coded. When the loader encounters the branch in- 
struction produced by the assembler, the loading 
process stops and a branch to the instruction whose 
label is entrya occurs. 
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Figure 65. ex Statement 

SFX - Suffix 

General Description: This statement directs the as- 
sembler to put a suffix code in the sixth position of 
all labels and symbolic operands that have five or 
fewer characters, until another sfx statement is en- 
countered. In this way, the programmer can use the 
same label in different sections of the complete 
program. 

In using the incld macro (see INCLD Macro), the 
same routine can be extracted more than once be- 
cause it is used in different program sections (there 
is a ltorg or ex statement between the two incld 
macros). In these cases use the sfx statement to 
ensure that the label does not appear exactly the 
same in two different sections of the program. Thus, 
the suffix code makes the labels in each section 
unique. 

The suffixing can be discontinued by an sfx state- 
ment with a blank operand. To prevent a particular 
label from being suffixed within a portion of the 
program in which the other symbols are being suf- 
fixed, make the label six-characters long. 

The programmer: 

1. Writes sfx in the operation field. 

2. Writes the character, which can be any valid char- 
acter, to be used for the suffix code in the operand 
field. 

The assembler: 

1. Inserts the suffix code in the sixth position of all 
labels in the source program that have fewer than 
six characters. 

2. Changes the suffix code when a new sfx card is 
encountered. 

Result: Each program section has unique labels. 

Example: Figure 66 is an example of coding for a 
suffixing operation. 
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Label 

6 IS 


Operation 

16 20 


OPERAND 

21 25 SO 35 40 43 SO 


i . . . 


*>f X. 


A 


EHT.RV. ! . . . 


&A , , 


FEi.j>A.j.F.£.i..an 



Figure 66. Specifying a Suffix Operation 



XFR — Transfer 

General Description: This entry is like ex except that 
it does not signal the assembler to include literals 
and closed library routines in the object program. 



END - End 

General Description: The end statement signals the 
assembler that all of the source-program entries 
have been read. This card, which is always the last 
card in the source-program deck, provides the as- 
sembler with the information necessary to produce 
a branch instruction. The branch instruction in 
turn causes a transfer to the first instruction to be 
executed after the object program has been loaded. 

The programmer: 

1. Writes end in the operation field. 

2. Writes an actual or symbolic address in the oper- 
and field. This must be the same symbol as the 
label of the first instruction to be executed after the 
loading processor has been completed. 

The assembler: 

1. Assembles an unconditional-branch instruction for 
1440 systems, and a clear-storage-and-branch in- 
struction for 1401 and 1460 systems. The I-address 
of this instruction is the equivalent address of the 
first instruction to be executed after the loading 
process has been completed. This instruction does 
not become part of the object program. However, 
it is used by the loading routine to transfer machine 
instruction execution to the object program. 

2. Causes literals and closed library routines that have 
previously been encountered to be included at this 
point in the object program. 

Result: Object-program execution begins automati- 
cally after loading. 

Example: Figure 67 shows an end statement. 



Label 



Operation 
_ua tStti- 



-UL 



OPERAND 
_48 



fcflo, , Is.TAftr; , 



ULST-Stop Listing 

General Description: This operation stops the output 
listing of specified portions of the program. All 
other output options are not affected. 

The programmer: 

1. Writes ulst in the operation field. 

2. Inserts the ulst card at the beginning of the section 
that is not to be listed. 

The assembler: 

1. Stops printing the output listing. 

2. Indicates that this portion of the listing is being 
skipped. 

Example: Figure 68 shows an ulst statement. 



Label 



Operation 
ISMe 2021 



U.L.S.T. 



OPERAND 
_SS 52 



Figure 68. ulst Statement 

LIST -Start Listing 

General Description: To resume listing after an ulst 
operation has been in effect, the list operation is 
specified. 

The programmer: 

1. Writes list in the operation field. 

2. Inserts the card at the end of the section which 
has not been listing. 

The assembler: resumes printing the output listing. 

Example: Figure 69 shows a sample list statement. 



Label 

6 IS 


Operation 
IS 20 


OPERAND 

21 2S SO SS 40 4S SO 


1 
i . . . 


Li. ST. 





Figure 67. end Statement 



Figure 69. list Statement 



SPCE — Space n Lines 

General Description: This operation causes the assem- 
bler to insert extra spaces in the output listing. 

The programmer: 

1. Writes spce in the operation field. 

2. Writes the numeric character 1, 2, or 3 in column 
21. Use 1 for no space before printing, that is, single 
space printing, 2 for one space before printing, that 
is, double space printing, and 3 for two spaces be- 
fore printing, that is, triple space printing. 
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3. Inserts the spce card following the card after which 
the spacing is to start. 

The assembler: Leaves the specified number of spaces 
after each line printed until another spce card is 
encountered. If no spce card is included in the 
source deck, the assembler will not leave any spaces 
between printed lines. 

Example: Figure 70 shows a space statement that 
causes the assembler to leave one space between 
lines in the output listing. 



Label 



Operation 
J3I3 tVfi' 



b.PC£ 12 . 



OPERAND 
_15 SS 



Figure 70. spce Statement 



SKIPN— SKIP TO NEXT PAGE 



General Description: This operation causes the as- 
sembler to skip to the next page of the printed 
output listing. Thus, the programmer can force the 
start of a new listing page without having to use a 
job card. 

The programmer: Writes SKIPN in the operation field. 

The assembler: Skips to the next page in the output 
listing. 

Example: Figure 71 shows a SKIPN statement. 



Label 



Operation 

!S 



?Aim 



OPERAND 
—ii as 



2. The fixed-form sps language format described in IBM 
1401 Symbolic Programming Systems: SPS-1 and SPS-2, 
Form C24-1480. 

3. The free-form Basic Autocoder format described in Basic 
Autocoder for IBM 1440: Specifications, Form C24-3023. 

The programmer: 

1. To enter Basic Autocoder from full Autocoder, 
writes ent in columns 16-18 and writes basic in 
columns 21-25. 

2. To enter full Autocoder from Basic Autocoder, 
writes ent in columns 36-38, and writes autocoder 
in columns 41-49. 

3. To enter sps: from full Autocoder, write ent in 
columns 16-18, and write sps in columns 21-23. 
(sps statements are assembled into 1401-1460 ma- 
chine-language coding. ) 

4. To enter full Autocoder from sps, writes ent in 
columns 14-16 and writes autocoder in columns 
17-25. 

The assembler: Interprets the source-program coding 
as identified by the ent statements. 

Result: Programs prepared partially in sps or Basic 
Autocoder format can be reassembled by the Auto- 
coder assembler. 

Examples. Figures 72, 73, 74, and 75 are ent state- 
ments to be used with Autocoder. 



I 
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Figure 72. Enter Basic Autocoder from Autocoder 



Figure 71. SKIPN Statement 
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ENT — Enter New Coding Mode 



Figure 73. Enter Autocoder from Basic Autocoder 



General Description: An ent statement is used by the 
programmer to inform the assembler that a change 
in coding form follows. The end card must be 
processed in the full Autocoder mode. 

The Autocoder assembler accepts source pro- 
grams coded in any of these three formats: 

1. The standard free-form Autocoder format described in the 
Coding Sheet section of this publication. 



Label 



Operation 
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EMT. . 
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Figure 74. Enter sps from Autocoder 



Label 



Operation 
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Figure 75. Enter Autocoder from sps 



OPERAND 
_sa 39. 



OPERAND 

_ss as 
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The Macro System 



Many program routines are quite general. These rou- 
tines (consisting of a series of instructions originally 
developed to handle one phase of one specific pro- 
gram) can, with little or no alteration, be incorporated 
in other programs. For example, a routine for checking 
the accuracy of a write-disk operation can be used, 
with modification of addresses, in many programs. 

The Autocoder system includes a macro facility that 
eliminates the repetitive coding of general routines. 
Before the macro facility can be used, the user must 
create a library by storing the routines in disk storage. 
The user can then write a single symbolic instruction 
(a macro instruction) that causes the assembler to ex- 
tract the routine associated with the instruction, tailor 
it to fit the program requirements, and insert it in the 
object program. 

ibm provides several macro instructions and library 
routines. Others can be developed by the user, then 
stored in the library and incorporated into programs 
as needed. 



Library Routines 

A library routine is a complete set of instructions de- 
signed to perform a specific operation. The name of 
a library routine is referred to as a macro name. This 
name is used as a header label in the disk-storage 
record that contains the routine. It is also used to 
specify the routine in a macro instruction. Each library 
routine must have a unique macro name. A source 
program cannot contain more than 99 macro names. 
This is the maximum number of routines that can be 
in the Autocoder library. 

Library routines are written on a coding form de- 
signed to organize them into the format required by 
the assembler. Figure 76 shows the library coding 
form. (See Developing the Library Routine.) 

During the librarian phase of Autocoder, the rou- 
tines are transferred to the disk-storage library. (See 
INSER - Insert and DELET - Delete.) At program 
assembly time the required routines are extracted, 
tailored to fit program requirements if necessary, and 
inserted in the symbolic source program. The source 
program, including the symbolic library entries, is 
then processed by the assembler to produce the ma- 
chine-language object program. 



Flexible Library Routines 

A routine that can be tailored to fit program require- 
ments is a flexible library routine. These routines con- 
sist of model statements that are general outlines for 
symbolic-program statements. During program assem- 
bly, the macro-generator phase of the assembler pro- 
gram replaces the codes in model statements with 
the parameters (symbolic addresses, control fields, or 
other information) specified in the source-program 
macro instructions. Model statements can be deleted 
if they are not needed in the program. 

Flexible library routines may contain pseudo macro 
instructions. These are commands to the macro gen- 
erator that control the production of the symbolic 
routine. Pseudo macros are never used by the source 
programmer. They are used by the library programmer 
when he develops the library routine. 



Inflexible Library Routines 

A library routine that requires no alteration is an 
inflexible library routine. All the instructions (model 
statements) are incorporated in the symbolic program. 
No parameters may be inserted. The data needed by 
the routine must be in the locations indicated by the 
symbolic addresses in the operand fields of its instruc- 
tions. An inflexible library routine is called an incld 
routine because the incld macro instruction causes 
the assembler to insert it in the symbolic source pro- 
gram. 



Macro Instructions 

General Description. A macro instruction is the entry 
in the source program that specifies the routine to 
be extracted from the library and inserted in the 
program. It also gives the assembler the informa- 
tion necessary to tailor a flexible library routine. 

An incld or call macro instruction must be used 
to insert an inflexible library routine in the program. 
A regular macro instruction (contains the name of 
the library routine in the operation field) is used to 
tailor and incorporate a flexible library routine. The 
following discussion applies to regular macro in- 
structions. (See INCLD Macro and CALL Macro.) 
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Figure 76. ibm Autocoder Library Coding Form 



The source programmer: 

1. Writes the macro name (the name of the library 
routine) in the operation field of the Autocoder 
coding sheet. 

2. Writes in the label field the name that is to be 
used as the label of the first statement in the gen- 
erated symbolic routine. 

3. Writes in the operand field the parameters that are 
to be used by the model statements required for the 
particular object routine as follows: 

a. Parameters must be written in the sequence in 
which they are used by the codes in the model 
statements. For example, if cost is parameter 1, 
it must be written so that it will be substituted 
wherever a n01, or nOA appears in a label, oper- 
ation code, or operand field of a model statement. 

b. A macro instruction may have as many param- 
eters as can be written in the operand fields of 
five or fewer coding-sheet lines. If more than one 



coding-sheet line is needed for a macro instruc- 
tion, the label and operation fields of the addi- 
tional lines must be left blank. Parameters must 
be separated by a comma. A parameter may not 
contain blanks or commas unless they are en- 
closed by @ symbols (as in an alphameric 
literal). The @ symbol itself must not appear 
between @ symbols in a parameter. 

If more than one line is needed to list the 
parameters for a given macro instruction, a 
comma must be written after the last parameter 
of each line. A comma is not needed after the 
last parameter listed for the macro, 
c. A parameter, or parameters, may be omitted if 
not required for the object routine. To omit a 
parameter, include the comma that would have 
followed the parameter, unless the parameter to 
be omitted follows the last parameter used in the 
macro instruction. The assembler uses these 
commas to count parameters up to and including 
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the last included parameter. All parameters be- 
tween the last one included and parameter 99 
are assumed by the assembler to be absent. 

The assembler: 

1. Extracts the library routine and selects the model 
statements required for the routine as specified by 
the parameters in the macro instructions, by the 
substitution and condition codes in the model 
statements, and by the pseudo macros in the library 
routine. 

2. Substitutes parameters when they are indicated in 
the model statements, producing the symbolic rou- 
tine. 

Result. The symbolic routine is merged into the sym- 
bolic program following the macro instruction. This 
routine is called an open or in-line routine because 
it is inserted directly into a larger routine without 
linkage or calling sequence. 

Figure 77 shows the effect of a regular macro 
instruction. 

Example. To illustrate the basic operation of the macro 
system, a hypothetical macro named check, with a 
simple flexible library routine, is shown here. 

This routine is designed to compare an input field 
to another field, and to test the compare indicators 
for a high, low, or equal condition (or any combina- 
tion of the three) as prescribed by the macro in- 
struction in the source program. For example, the 
source programmer may use the object routine to 
test only for an equal condition in one program; in 
another, high or equal. 

Figure 78 shows the library routine and a sample 
macro instruction specifying that a routine using all 
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When a regular macro instruction is encountered in the source pro- 
gram, the assembler extracts the specified library routine, tailors it, 
and inserts it in-line in the user's source program. 

Figure 77. Macro Processing 
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Macro Instruction 
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Figure 78. Macro Operations 
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Figure 79. Parameters for exact included; Parameters 10-99 Missing 
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Figure 80. Parameters 04, 08, and 10-99 Missing 



the model statements is needed in the object pro- 
gram. The symbolic routine generated by the as- 
sembler is also shown. The symbolic routine is in- 
serted in the symbolic program following the macro 
instruction. During assembly of the object program, 
the symbolic program will be translated to actual 
machine-language instructions. The actual addresses 
of the symbols supplied as parameters in the macro 
instruction will be inserted in the label, operation, 
and operand fields. 

Examples. Figures 79, 80, 81, and 82 show how param- 
eters can be omitted. A hypothetical macro instruc- 
tion called exact is used, exact can have as many as 
nine parameters. 
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Figure 81. Parameters 01, 04, 05, 06, 08, 10-99 Missing 
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Figure 82. Parameters 01 and 03-99 Missing 



program, the library routine is included in the pro- 
gram when the assembler encounters an ex or end 
statement. 

2. Incorporates the library routine only once per pro- 
gram or overlay, regardless of how many incld 
statements name the same routine. 

Note: The programmer must insert a branch in- 
struction at the place in the main routine at which 
the exit to the library routine is needed. Several 
incld statements can be written in a group in the 
source program to cause the associated library rou- 
tines to be incorporated by the assembler at ltorg, 
end, or ex time. Thus, one exit from the main rou- 
tine can be used to cause several library routines 
to be executed at object-program execution time. 

Note: There can be no more than 30 incld state- 
ments within any one program overlay. 

Result. An inflexible library routine is included in 
the symbolic source program. This routine is called 
a closed or out-of-line routine because it is entered 
by a basic linkage (a branch instruction) from the 
main routine. 

Figure 83 shows the effect of an incld macro in- 
struction. 



INCLD Macro 

General Description. This macro extracts an inflexible 
library routine from the disk-storage library. The 
programmer establishes his own linkage to the 
closed routine. 

The source programmer: 

1. Writes incld in the operation field. 

2. Writes the name of the library routine in the oper- 
and field. 

The assembler: 

1. Extracts the library routine at Literal Origin time. 
If no ltorg statement appears in the user's source 



Example. Figure 84 shows an incld statement used 
to extract an inflexible library routine named subrtI. 
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Figure 84. incld Macro 



CALL Macro 



General Description. The call macro provides linkage 
to inflexible (closed) library routines and generates 
the incld statement needed to incorporate the rou- 
tine in the source program. 
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When the assembler encounters an INCLD macro, it incorporates the 
specified library routines when an LTORG, END, or EX statement is 
encountered in the user's source program. Note that the branch instruc- 
tion that links the main routine to the closed library routine is pro- 
vided by the programmer. 





Figure 83. incld Processing 



The source programmer: 

1. Writes call in the operation field. 

2. Writes the name of the routine in the operand field. 
The routine name must also be the label of the first 
instruction to be executed. 

3. May write a maximum of ten operands immediately 
after the routine name. The assembler generates a 
dcw for each of these operands so that they can be 
used as labels or data in the routine. 

The assembler: 

1. Advanced programming or indexing-and-store-ad- 
dress-register feature not available: 

a. Generates a label and a move instruction. When 
the program is executed, the equivalent address 
of the label is moved to a three-character field 
immediately ahead of the first instruction to be 
executed. (In the routine, the statement that pre- 
cedes the first instruction to be executed must 
define the three-character field.) 

If any dcw's are generated, the equivalent ad- 
dress of the label is the address of the units posi- 
tion of the first dcw. 

If no dcw's are generated, the equivalent ad- 
dress of the label is the address of the instruction 



that follows the call statement in the source 
program. 

Because an address is stored in the three- 
character field, the library programmer can plan 
the use of the generated dcw's and prepare link- 
age back to the main routine. 

b. Generates a branch instruction to the first in- 
struction to be executed. 

c. Generates an incld statement. 

d. Generates dcw's for the operands that follow 
the routine name. The dcw's immediately follow 
the branch instruction in the object program. 

Advanced programming or indexing-and-store-ad- 
dress-register feature available: 

a. Generates a branch instruction to the first in- 
struction to be executed. The first statement to 
be executed must be an sbr instruction. 

If any dcw's are generated, the address stored 
is the address of the high-order position of the 
first dcw. 

If no dcw's are generated, the address stored 
is the address of the instruction that follows the 
call statement in the source program. 
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The sbr instruction enables the library pro- 
grammer to plan the use of the generated dcw's, 
and to prepare linkage back to the main routine. 

b. Generates an incld statement. 

c. Generates dcw's for the operand that follows the 
routine name. The dcw's immediately follow 
the branch instruction in the object program. 

2. Extracts the library routine at Literal Origin time. 
If no ltorg statement appears in the user's source 
program, the routine is included in the program 
when the assembler encounters an ex or end state- 
ment. 

3. Incorporates the routine only once per program or 
program overlay, regardless of how many incld or 
call statements name the same routine. 

Example. Figure 85 shows a call statement with three 
operands and the statements generated by the as- 
sembler. Assume that the object machine does not 
have the advanced programming or indexing-and- 
store-address-register feature. The figure also shows 
the portion of the library routine that utilizes the 
three-character field immediately ahead of the first 
instruction in the routine. 
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CHAIN Macro 

General Description. The chain macro makes it easier 
for the programmer to code chained instructions. 

The source programmer: 

1. Writes the instruction to be chained. 

2. Writes the macro instruction, using chain as the 
mnemonic operation code, and writes a number 
from 1 to 99 in the operand field. This number 
represents the number of chained instructions de- 
sired. 

The assembler: Repeats the operation code as many 
times as specified by the chain macro. 

Example. Figure 86 shows how an mlc statement can 
be chained five times. 
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Figure 85. call Macro 
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MA Macro — Modify Address 

General Description. The source programmer may use 
the ma macro instruction to modify a one- or two- 
address instruction, if the modify-address feature is 
not available in the object machine. The modify- 
address feature is an additional operation code (ma- 
modify address) that is standard on all ibm 1460 
systems and on ibm 1401 and 1440 systems with 
more than 4000 positions of core storage. 

The ma macro is supplied by ibm as part of the 
Autocoder library. The assembler determines if the 
machine instruction can be issued (if the modify- 
address feature is available), or if the symbolic rou- 
tine (generated from the library routine) is to be 
inserted in the source program. 

The source programmer: 

1. Writes ma in the operation field. 

2. May write a label in the label field. 

3. Writes the macro instruction with one or two oper- 
ands. An alphameric literal used as an operand 
must be three characters. 



The assembler: 

1. Selects the model statements necessary to modify 
the correct address(es). The presence or absence of 
parameters in the source-program macro instruction 
determines which model statements are to be used. 

2. Puts the label (if any) in the first instruction used 
for the address modification routine. 

Result. Tailored symbolic-program statements are in- 
serted as an open routine in the program. 

Examples. Figure 87 shows a routine designed to 
move all the items from a card to their proper places 
in the area named table, using a single move in- 
struction ( named save ) to perform all the necessary 
moves. Two ma macro instructions (ready and 
adjust) are used to modifiy the operands of the 
move instruction. In analyzing the routine, assume 
that every fifteenth column in each input card con- 
tains the last character of an item of information 
and that word marks have been previously set in 
the read area to identify the beginning of each item. 
Also, for the benefit of 1440 users, the read-and- 
branch instruction (R ADJUST) used in the rou- 
tine is a 1401-1460 instruction that causes a card to 
be read and then a branch to be made to the address 
specified in the operand. 

Figure 88 shows the ma macro instruction with 
a parameter for the A-address only. The symbolic 



routine generated by the assembler processor is 
also shown. 
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Macro Instruction 
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Figure 88. ma Macro with One Parameter 

LOOP Macro 

General Description. This macro generates instruc- 
tions to execute a loop a specified number of times. 
This may be any number within the range 1-999. The 
loop macro is the last instruction in the loop. 

The source programmer: 

1. Writes loop in the operation field. 

2. May write a label in the label field. 

3. Writes the parameters in the operand field in this 
order: 

Parameter 1. The symbolic address of the first in- 
struction in the loop. 
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equivalent address of TABLE because the label 
of the area-defining DCW begins in column 7. 

Figure 87. ma Macro with Two Parameters 
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Parameter 2. The symbolic address of a one-, two-, 
or three-position field that contains the number 
that indicates how many times the loop is to be 
executed. After looping is completed, the loop 
counter is reinitialized to the original number. 

Parameter 3. The number that indicates how many 
times the loop is to be executed. After looping is 
completed, the loop counter is automatically re- 
initialized to the number specified. 

Note: Use either parameter 2 or parameter 3, 
but not both. No reinitialization takes place on 
the loop counter if an exit is taken within the 
loop. 

Example. The macro instruction shown in Figure 89 
causes the program to branch to test3 eight times 
to execute the loop nine times. 
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Figure 89. loop Macro 



Example. (Figure 90) Compare stock on hand (stock) 
to projected usage (usage). If the stock on hand is 
lower than the projected usage, branch to the re- 
order routing (reordr). 
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Figure 90. compr Macro 



Linkage Macros 

Autocoder (on Disk) provides two linkage macros, 
ldrcl and syscl. The ldrcl macro facilitates the exe- 
cution of object programs (or program overlays) that 
are to be loaded from disk (coreload format). The 
syscl macro enables the user to stack jobs (such as 
program assemblies, program executions, and librarian 
operations) under control of Autocoder (on Disk). 

Note: Object-program formats and Autocoder jobs 
are described in Autocoder (on Disk)' Program Speci- 
fications and Operating Procedures for IBM 1401, 
1440, and 1460, Form C24-3259. 



COMPR Macro 

General Description. This macro generates instruc- 
tions to compare and test indicators for low, equal, 
or high results. Rules for word-mark control or 
low, equal, or high indication are the same as for 
the machine compare instruction. 

The source programmer: 

1. Writes compr in the operation field. 

2. May write a label in the label field. 

3. Writes the parameters in the operand field in this 
order: 

Parameter 1. The symbol of the A-field to be com- 
pared. 

Parameter 2. The symbol of the B-field to be com- 
pared. 

Parameter 3. The symbolic address of the next in- 
struction, if a branch occurs as a result of a low 
condition. 

Parameter 4. The symbolic address of the next in- 
struction, if a branch occurs as a result of an 
equal condition. 

Parameter 5. The symbolic address of the next in- 
struction, if a branch occurs as a result of a high 
condition. 

Note: Any or all of the parameters 3,4, and 5 
may be included for the compr macro. 



LDRCL Macro 

General Description. The ldrcl macro enables the 
programmer to resume loading an object program 
from disk after a portion of the program has been 
executed. The machine size specified in the ctl card 
determines the location of the disk loader. The lo- 
cations are 3701 for 4K, 7701 for 8K, 11701 for 12K, 
and 15701 for 16K. The ldrcl macro generates the 
appropriate branch instruction. 

The programmer can also use the ldrcl macro to 
begin loading another independent object program 
that is in the coreload format. 

The source programmer: 

1. Writes ldrcl in the operation field of the macro 
instruction. 

2. If another independent object program is to be 
loaded, from disk, the programmer must precede 
the ldrcl macro instruction with an instruction that 
will move the starting address of the next program 
to the core storage locations that contain the ad- 
dress of the next section to be read (3831 for 4K, 
7831 for 8K, 11831 for 12K, and 15831 for 16K). 

SYSCL Macro 

General Description. The syscl macro causes the as- 
sembler to generate a branch instruction to the 
bootback routine, which transfers program control 
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to the System Control Program after the object pro- 
gram (card format or coreload format) has been 
executed. The System Control Program reads the 
control card for the next job and initiates the proc- 
essing required to perform the job. 

The machine size specified in the ctl card de- 
termines the location of the bootback routine. The 
locations are 3928 for 4K, 7928 for 8K, 11928 for 12K, 
15928 for 16K. 

When used, the syscl macro should be the last in- 
struction executed in the source program. 

The source programmer: writes syscl in the operation 
field of the macro instruction. 



Arithmetic Macros 

These macros are incorporated in Autocoder to make 
it easier to program addition, subtraction, multiplica- 
tion, and division. 

The following information applies to all arithmetic 
macros: 

1. Permanent switches set from information in the 
ctl card govern the uses of the indexing-and-store- 
address-register, modify-address, and multiply/ 
divide features. 

2. Any positive set of decimal-place configurations is 
considered valid. (This includes zeros.) They must 
be expressed as unsigned integers. 

3. A literal may be used as a parameter wherever the 

the name of a field is required. 

• 4. The fields from which values are obtained are not 
modified in any way. The symbols for these fields 
are used as parameters 1 and 4. 

5. Rounding is performed by computing the result 
to one extra position of accuracy, and then adding 
five to the extra position. 

6. Whenever rounding or editing is required, a tem- 
porary result field is used. 

7. The result field need not be set to zeros before 
the macro routine is entered. 

8. Actual decimal points appear only in edited re- 
sults. 

9. The absence of the sign-control parameter (12) 
causes shorter (and slightly faster) macro routines. 

10. The result field must be large enough to contain 
the complete edit-control word. 



ADD Macro 

General Description. This macro produces a routine 
that adds two fields, and stores the result in a third 
field. 

The source programmer: 

1. Writes add in the operation field. 

2. May write a label in the label field. 

3. Writes parameters in the operand field in this order: 

Parameter 1. The name of the first field to be 
added. This must be the field with the lesser 
number of decimal places unless both fields have 
the same number of decimal places. 

Parameter 2. The length of the field specified in 
parameter 1 (number). 

Parameter 3. The number of decimal places in the 
field specified by parameter 1. If there are no 
decimal places, use a zero. 

Parameter 4. The name for the second field to be 
added. This must be the field with the greater 
number of decimal places unless both fields have 
the same number of decimal places. 

Parameter 5. The length of the field specified in 
parameter 4 (number). 

Parameter 6. The number of decimal places in the 
field specified in parameter 4. If there are no 
decimal places, use a zero. 

Parameter 7. The name of the result (sum) field. 

Parameter 8. If editing is not used, this number is 
the length of the result field. If editing is used, 
this number must correspond to the number of 
blanks and zeros in the edit-control word. 

Parameter 9. The number of decimal places desired 
in the result. 

Parameter 10. Truncate parameter (T). The T in- 
dicates that the result is not to be rounded. If 
parameter 10 is absent, the result will be rounded, 
provided the number of decimal places specified 
for the result is less than the number of decimal 
places specified for either of the two fields to be 
added. 

Parameter 11. This may be either the name of an 
edit-control word for the result, or an edit-control 
word expressed as an alphameric literal. 

Parameter 12. S indicates sign-control for negative 
and positive numbers. If parameter 12 is absent, 
numbers will be handled as positive, and must 
not have negative zones. 

Note: Parameters 10, 11, and 12 are optional. 
All others must be present. 
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Example. (Figure 91) Add the contents of a field called 
cash to the contents of a field called recpts, and 
store the result in a field called totals. 



CASH 


XXXX.00 


RECPTS 


XXX.00 


TOTALS 


XXXXX.00 
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Figure 91. add Macro 

SUB Macro 

General Description. The subtract macro subtracts 
one field from another and stores the result in a 
third field. 

The source programmer: 

1. Writes sub in the operation field. 

2. May write a label in the label field. 

3. Writes parameters in the operand field in this order. 
Parameter 1. The name for the minuend field 

(quantity from which another field is subtracted). 

Parameter 2. The length of the minuend (number). 

Parameter 3. The number of decimal places in the 
minuend. Specify zero if there are no decimal 
places in this field. 

Parameter 4. The name for the subtrahend (quan- 
tity to be subtracted from another field). 

Parameter 5. The length of the subtrahend (num- 
ber). 

Parameter 6. The number of decimal places in the 
subtrahend. Specify zero if there are no decimal 
places in the field. 

Parameter 7. The name for the result (difference) 
field. 

Parameter 8. If editing is not used, this number is 
the length of the result field. If editing is used, 
this number must correspond to the number of 
blanks and zeros in the edit-control word. 

Parameter 9. The number of decimal places in the 
result. Specify zero if there are no decimal places 
in this field. 

Parameter 10. Truncate parameter (T). The T indi- 
cates that the result is not to be rounded. If pa- 
rameter 10 is absent, the result will be rounded, 



provided that the number of decimal places spec- 
ified for the result is less than the number of 
decimal places specified for either the minuend 
or the subtrahend. 

Parameter 11. The name of an edit-control word 
for the result, or an edit-control word expressed 
as an alphameric literal. 

Parameter 12. S indicates sign-control for negative 
and positive numbers. If parameter 12 is absent, 
the minuend and subtrahend will be handled as 
positive fields and therefore must not have nega- 
tive zones. If a negative result is possible, sign- 
control should be used. 

Note: Parameters 10, 11, and 12 are optional. 
All other parameters must be included. 

Example. (Figure 92) Subtract a field called issues 
from a field called instck and store the result in a 
field called balan. 



ISSUES 


XXXX 


INSTCK 


XXXXXX 


BALAN 


XXXXXX 



Multiply and Divide Macros 

If the multiply/divide feature is included in the ma- 
chine used to execute the object program, the multiply 
and divide macros will use it (if the feature has been 
specified in the ctl card). However, if this feature is 
not present in the object machine, the multiply and 
divide macros provide instructions to perform these 
operations. 



MLTPY Macro 

General Description. The multiply macro multiplies 
one field by another and stores the result in a third 
field. 

The source programmer: 

1. Writes mltpy in the operation field. 

2. May write a label in the label field. 

3. Writes the parameters in the operand field in this 
order: 

Parameter 1. Multiplier field (name). For maximum 
efficiency this should be the shorter field involved 
in the multiplication. 
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Figure 92. sub Macro 
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Parameter 2. Length of the multiplier field (num- 
ber). 

Parameter 3. Number of decimal places in the mul- 
tiplier field (number). 

Parameter 4. Multiplicand field (name). 

Parameter 5. Length of the multiplicand field 
(number). 

Parameter 6. Number of decimal places in the 
multiplicand field (number). 

Parameter 7. Product field (name). 

Parameter 8. If editing is not used, this number is 
the length of the result field. If editing is used, 
this number must correspond to the number of 
blanks and zeros in the edit-control word. 

Parameter 9. Number of decimal places in the de- 
sired product field (number). 

Parameter 10. Truncate parameter (T). The T in- 
dicates that the answer (product) is not to be 
rounded. The answer will be rounded if param- 
eter 10 is missing, and if the number of decimal 
places in the product field desired is less than the 
sum of the number of decimal places in the multi- 
plier and multiplicand fields. 

Parameter 11. This parameter can be either the 
name of an edit-control word for the answer, or a 
control word expressed as an alphameric literal. 

Parameter 12. This parameter is an S that indicates 
sign-control for positive and negative numbers. If 
parameter 12 is missing, numbers will be treated 
as positive and in this case, must not have nega- 
tive zones. 

Note: Parameters 3, 6, 9, 10, 11, and 12 are 
optional. However, parameters 3, 6, and 9 must 
all be included if any decimal number is used. 

Example: (Figure 93) multiply a field called hours by 
a field called rate, and store the result in a field, 
called gross. edtwdI is used to edit the result field. 



HOURS 


XX.00 


RATE 


XX.00 


GROSS 


XXXX.00000 


DIVID Macro 





General Description. The divide macro divides one 
field into another and stores the result in a third 
field. The macro does not provide for division by 
zero. The user should test the divisor field before 
using the divide macro. 



The source programmer: 

1. Writes divid in the operation field. 

2. May write a label in the label field. 

3. Writes the parameters in the operand field in this 
order: 

Parameter 1. Divisor field (name). 
Parameter 2. Length of the divisor field (number). 
Parameter 3. Number of decimal places in the di- 
visor field (number). 

Parameter 4. Dividend field (name). 

Parameter 5. Length of the dividend field (number). 
If extra quotient digits are to be developed, the 
divide macro will insert low order zeros and shift 
the sign. 

Parameter 6. Number of decimal places in the di- 
vidend field (number). 

Parameter 7. Quotient field (name). 

Parameter 8. If editing is not used, this number is 
the length of the result field. If editing is used, 
this number must correspond to the number of 
blanks and zeros in the edit-control word. 

Parameter 9. Number of decimal places desired in 
the quotient field (number). 

Parameter 10. Truncate parameter (T). The T in- 
dicates that the answer (quotient) is not to be 
rounded. The answer will be rounded if param- 
eter 10 is missing, and if parameters 3, 6, and 
either 9 or 13 are present. 

Parameter 11. This parameter is either the name of 
an edit-control word for the answer, or a control 
word expressed as an alphameric literal. 

Parameter 12. This parameter is an S that indicates 
sign-control for positive and negative numbers. 
If parameter 12 is missing, numbers will be 
treated as positive and must not have negative 
zones. 

Parameter 13. Remainder field (name). This param- 
eter may be used with parameter 7 if both the 
quotient field and the remainder are desired. 
Parameter 7 may be omitted if only the remainder 
is desired. However, at least one of the parameters 
(7 or 13) must be included for the divid macro. 
When the multiply-divide feature is specified, 
the sign of the remainder will be the sign of the 
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Figure 93. mltpy Macro 
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dividend. If the feature is not specified, the sign 
of the remainder will always be positive. 

Note: Parameters 3, 6, 7, 8, 9, 10, 11, 12, and 13 
are optional. If any decimal number is used, 
parameters 3, 6, and either 9 or 13 all must be 
included. 

Example. (Figure 94) Divide a field called sums by a 
field called factor, and store the result in a field 
called AVERAG. 



SUMS 


XXXX.00 


FACTOR 


XX. 


AVERAG 


XXX.000 



Label 



Operation 
islie to t i 



OPERAND 

_ja m 



ID IV I DIFA.C.T0.R r Z. r 0., S.UMS. r o.,.;LjAV.ER AAj.S ,3 



Figure 94. divid Macro 



Developing Library Routines 

General Description. The library routine is a general 
routine designed to perform many specific functions 
(depending on the parameters supplied ,by the 
source programmer in his macro instruction) when 
it is executed in the object program. 

The library routines needed for a given installa- 
tion are prepared by the library programmer. In 
many cases the library programmer and the source 
programmer are the same person, but the two func- 
tions are separate and are thus treated here. 

The librarian phases of Autocoder maintain the 
library by inserting, deleting, and/or modifying 
library routines. At assembly time, the macro-gen- 
erator phases extract the routines named in macro 
instructions. 

The library programmer: 

1. Designs the general routine. 

2. Writes the model statements needed in the routine. 



Model Statements 

Library routines consist of model statements that 
establish the conditions for inserting parameters in 
the symbolic routine, and define the basic structure 
of the symbolic program entries produced by the 
macro generator. 

Model statements can be divided into two cate- 
gories: 

1. Complete (no parameters needed). The format of a 
complete model statement is the same as that of a 
source-program statement. A complete model state- 
ment is included in the generated symbolic routine 
unless a bypass condition exists. (See BOOL.) 

All model statements in an inflexible library rou- 
tine must be complete. 

Figure 95 shows a complete model statement 
designed to compare feelda to fieldb. 
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Figure 95. Model Statement for a Complete Instruction 



2. Incomplete. The substitution codes used by the 
library programmer determine if parameters are 
required or optional. 

a. Parameters required. A substitution code in the 
form n01-n99 indicates that a parameter must be 
supplied. The number that follows the n indi- 
cates the position of the parameter in the macro 
instruction. The statement, with the proper pa- 
rameters inserted, appears in the generated sym- 
bolic routine unless a bypass condition exists. 
Figure 96 shows a model statement that requires 
parameters, and a macro instruction that sup- 
plies the required parameters. 

Macro-Instruction 
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The librarian: enters the model statements in disk 
storage immediately following the heading informa- 
tion contained in the associated inser statement 
during the librarian phase of Autocoder. 

Result. The source programmer can write a macro in- 
struction in his source program that will cause the 
macro generator to extract and tailor the routine and 
insert it as an inline routine in the symbolic program. 



Model Statement 
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Figure 96. Incomplete Instruction with Required Parameters 
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Parameters optional. A substitution code in the 
form nOA-n9I indicates that a parameter is op- 
tional. (n01-n99 with A- and B-bits over the units 
position.) The statement is included in the sym- 
bolic routine only if the parameter is supplied by 
the macro instruction. This kind of model state- 
ment can also be bypassed by a bool statement. 
Figure 97 shows a model statement with a con- 
ditional substitution code. The nOC represents 
the third parameter of the macro instruction 
that extracts the routine. If the third parameter 
is supplied, the statement is included in the 
generated symbolic routine. If it is omitted, the 
statement is not inserted. 



Macro Instruction 



Label Operation 

'» '« ZS.ll 15 12 1S_ 



OPERAND 



TESTZ. , \lHV£R\SmRT.l,START2 J FNT/fVA 



Model Statement 



I Label 


Op«rotion 


Operand and Comment* 


4 7 I » 1011 1213 )4 IS 1*17 It 1*3021 >22334?S3« 27212*3031 32 33 34 35M37M 3*4041 4343 41 454*47 4« 49 S051 33 S3 54 355*37 SI 


'Wlllllllllll 


+M+N 1 



Generated Symbolic Program Entry 
START2 SBR ENTRYA 

Figure 99. Additional External Labels 



TTTTTHrrnWHeTTT 



Operand and Co 



1 22 23 24 25 36 27 38 293031 3233 3435 3637 38 3*4041 42 4344 4546 4748 49 50 51 52 S3 54 55 



Tmni 



Figure 97. Conditional Parameter 

A model statement in a flexible library routine can 
contain any combination of valid codes. The follow- 
ing descriptions state the kinds of codes that can be 
used in the label, operation, and operand fields of 
model statements. Figure 98 summarizes the uses of 
model-statement codes. 
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Figure 98. Model-Statement Codes 



Labels 



The two kinds of labels used in model statements are: 

1. External. These labels are used as operands in the 
source program. For example, if the model state- 
ment outlines an instruction that is an entry point 
for a branch instruction, the label of the statement 
must be the I-operand of the branch instruction. 

The label of the source-program macro instruc- 
tion causes the macro generator to produce an equ 
statement, in the form label equ *+l, as the first 
statement in the symbolic routine. The library pro- 
grammer can allow for additional external labels by 
writing a □ followed by a number (01-99) in the 
label fields of model statements that require labels. 



The source programmer must supply the label by 
writing the corresponding parameter in the macro 
instruction. 

Figure 99 shows a macro instruction and a model 
statement that produce an external label. 

2. Internal. These labels are used as operands in other 
model statements within the same library routine. 
To refer symbolically to instructions in flexible li- 
brary routines, write the code nOJ-n9R (01-99 with 
a B-bit over the units position) in the label field of 
the instruction, and use the label as the operand 
in another model statement. 

The macro generator produces an internal label 
in the form Dnn mmm, where nn is the code (0J- 
9R), and mmm is the number of the macro within 
the source program. These special symbolic ad- 
dresses are developed to ensure that duplicate core- 
storage addresses are not assigned to internal labels. 

A label used within an inflexible library routine 
must be written according to the rules of Auto- 
coder. It can be alphameric, must begin with a 
letter, must not contain blanks or special characters, 
and must not exceed six characters. 

Figure 100 shows a macro instruction and model 
statements that produce an internal label. Assume 
that updat is the 23rd macro in the source program. 



Operation Codes 

Any valid Autocoder mnemonic can be used in the 
operation field of a model statement. In flexible library 
routines, the library programmer can write a substitu- 
tion code in the form n01-n99 or n0A-n9I instead of 
a mnemonic. 

A model statement in the library routine for a macro 
instruction may not be another macro instruction ex- 
cept the incld macro. An incld model statement must 
have a $ symbol (11-3-8 punch) in column 6. 
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Macro Instruction 
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Figure 100. Internal Labels 



ltorg and ex statements may be used in library 
routines. If ltorg or ex is used in a library routine, 
closed library routines will not be included in the 
program at this point. 



Operands 

The library programmer can use any valid operand 
in a model statement. If a symbolic operand is used, 
it must appear as a label within the same library rou- 
tine or in a source-program statement. 

Any of the substitution codes can be used as model- 
statement operands in flexible library routines. If the 
code n01-n99 or nOA-n9I is used, the corresponding 
parameter must appear as a label in the source pro- 
gram. If the code nOJ-n9R is used, it must appear as 
the label of another model statement within the same 
flexible library routine. 

Liierals 

Literals are valid in all model statements. In flexible 
routines, substitution codes (n01-n99 or nOA-n9I) can 
represent a literal or any part of a literal. 

Address-Adjustment and Indexing 

The parameters in a macro instruction, and the oper- 
ands in partially complete instructions in a library 
routine, can have address-adjustment and indexing. If 



address-adjustment is used in both the parameter and 
in the model statement, the generated symbolic instruc- 
tion will be adjusted to the algebraic sum of the two. 
For example, if the address-adjustment of one is +7 
and the other is — 4, the generated instruction will 
have an address-adjustment factor of +3. 

Operands may be indexed in the library routine. 
However, if a parameter supplied by the macro in- 
struction is also indexed, the parameter will be indexed 
by the index code in the model statement in the li- 
brary routine. 

Special Requirements for INCLD 

Library Routines 

The inflexible library routines that the library pro- 
grammer develops for use with the incld (or call) 
macro have several requirements that must be con- 
sidered. 

1. Every entry point in the routine should have a label. 
If a call macro is to be used to generate the rou- 
tine, the first five characters of every entry point 
label must be the same as the name of the routine. 
This is required because a call uses the first five 
characters of the entry beginning in column 21 of 
the call statement to generate the routine, and the 
first six characters of the entry to generate a branch 
to the routine. This same labeling procedure may 
be used if the routine is generated by an incld. As 
with the call, only the first five characters, begin- 
ning in column 21 of the incld statement, are used 
to generate the routine; however, the source pro- 
grammer must still code a branch to the routine. 
Note that if this labeling procedure is used for an 
incld routine with more than one entry point, suffix- 
ing (see SFX-Suffix) cannot prevent the occurrence 
of multiple-defined labels if the routine is generated 
two or more times within a program. 

2. For routines called by incld's, the first instruction at 
each entry point must store the contents of the 
B-address register (SBR) in an index location or in 
the last instruction executed in the library routine. 
This provides for re-entry in the proper place in the 
main routine after the incld routine has been exe- 
cuted. 

Note: If the object machine does not have the advanced 
programming feature or the indexing-and-store-address- 
register feature, the programmer must provide other linkage 
back to the main routine. An example of such linkage is 
shown in Figure 101. (For linkage to routines brought out 
by call macros, see CALL Macro.) 

3. All macro instructions except incld are invalid in 
inflexible library routines. All other statements ac- 
ceptable to Autocoder, except end, may be used. 

4. incld statements may appear in either flexible or in- 
flexible library routines. An incld model statement 
should have a $ symbol (11-3-8 punch) in column 6. 
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the macro-generation phase of Autocoder. At the be- 
ginning of macro generation, all switches are off. 
During macro generation, if one of these storage posi- 
tions contains the character 1 (1-bit), the switch is on. 
If it contains a (8- and 2-bits), the switch is off. 



Library Routine 
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Figure 101. Sample Linkage between the Main Program 
and an incld Routine 



Pseudo Macro Instructions 

These are instructions that can be used by the library 
programmer to control the generation of symbolic rou- 
tines. They are never used by the source programmer, 
nor do they ever appear in the output listing of an as- 
sembled Autocoder program. 

They are written within library routines to signal 
the macro generator that certain conditions exist that 
affect the generation of the symbolic routines. For ex- 
ample, the presence of a pseudo-macro instruction in a 
library routine can cause the macro generator to de- 
lete one or more model statements when it develops 
the symbolic routine. Thus, pseudo macros provide 
the library programmer with a coding flexibility that 
exceeds the limitations of the substitution and condition 
codes. 

Pseudo-macro instructions may be written anywhere 
in a library routine. The three pseudo macros imple- 
mented by Autocoder are math, bool, and mend. 



Permanent and Temporary Switches 

The math and bool pseudo macros use internal indi- 
cators (switches) to signal the macro generator of ex- 
isting status conditions. (Model statements do not 
interrogate switches.) 

There are 99 permanent and 99 temporary switches 
that are used for recording status conditions during 
processing. Of these, permanent switches 06-50 and 
all 99 temporary switches are available to the user. 
Each switch occupies one core-storage position during 



Permanent Switches 

Permanent switches retain status conditions through- 
out the macro-generation phase unless they are changed 
by a pseudo macro. Address them by using a # sym- 
bol followed by the two-digit number of the switch 
to be set or tested. For example, #06 addresses per- 
manent switch 06, #07 addresses switch 07, and 
#49 addresses switch 49. 

Note: The Autocoder processor uses permanent 
switches #01, #02, #03, #04, and #05 to store in- 
formation from the control card. Permanent switches 
51-99 are reserved for the Autocoder assembler: 

1. The presence of the modify-address, advanced-pro- 
gramming, indexing-and-store-address-register fea- 
ture, and multiply/divide features in the object 
machine will set permanent switches #01, #02 and 
#03, respectively. 

2. Permanent switches #04 and #05 are set accord- 
ing to the storage capacity of the object machine as 
shown here. 



Storage Capacity 


#04 


#05 


4,000 


OFF 


OFF 


8,000 


OFF 


ON 


12,000 


ON 


OFF 


16,000 


ON 


ON 



Temporary Switches 

The 99 temporary switches are set at the time the 
macro generator encounters a macro instruction in the 
source program. Each of the 99 parameters that can be 
written in a macro instruction has a corresponding 
temporary switch that reflects the presence or absence 
of the parameter in the particular macro instruction 
being processed. If the parameter is present, the corre- 
sponding switch is set on. If the parameter is missing, 
the switch is set off. For example, if parameter 01 is 
present, temporary-switch 01 is turned on. If param- 
eter 02 is missing from the macro instruction, tempo- 
rary-switch 02 is off. 

Temporary switches retain status throughout the 
processing of a macro instruction unless changed by a 
pseudo macro. After the macro instruction has been 
completely processed, all temporary switches are set 
off. Temporary switches are addressed by using a □ 
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symbol followed by the two-digit number of the 
switch to be set or tested. For example, nOl addresses 
temporary switch 01; n02 addresses switch 02, and n99 
addresses switch 99. 

For another example, if a macro with a maximum of 
nine parameters is encountered, the macro generator 
sets the first nine temporary switches to indicate the 
presence or absence of these nine parameters. Tempo- 
rary switches 10-99, which are off, can be used by the 
pseudo macros to communicate conditions to the 
macro generator while it is working on this particular 
macro instruction. This use of temporary switches is 
recommended because it reserves the permanent 
switches for communicating information from one ma- 
cro to another. 
MATH — For Solving Algebraic Expressions 

General Description. A math pseudo macro contains 
as operands: sum boxes, arithmetic expressions, and 
sign switches. 

Sum Boxes 

A sum box is a group of five core-storage positions 
used to store the result of an arithmetic expression. 
Autocoder makes available 20 such sum boxes. A sum 
box is addressed by using a # symbol followed by the 
two-digit number (ending in zero or five) of the sum 
box to be referenced. For example, the address of the 
first sum box is #00; the address of the second sum box 
is #05; and the address of the twentieth sum box is 
#95. 

Note: Sum box 95 should not be reset, as it is used by the 
assembler. If the object program is to be in either condensed 
loader or coreload format, sum box 95 contains the address that 
branches back to the program loader after loading has been in- 
terrupted for execution of a part of the object program. For 
1440 systems, note that this branch-to address is the address of 
the loader for coreload format. The branch-to address for fhe 
condensed-loader format is the address of the loader + eight. 
Column 42 of the CTL card determines which of these two 
values is placed in sum box 95. If the object program is to be 
in the self-loading format, sum box 95 contains 0008L. 

At the beginning of the macro phase, a sum box 
contains 00000. Any number may be placed in a sum 
box or added to its contents. The units position of the 
sum box contains the sign of the result if it is negative. 
Sum boxes retain information placed in them through- 
out the macro phase, and their contents may be used 
and/or changed from one macro instruction to another. 

Sum boxes can be used by model statements, as 
well as by a pseudo macro. For example, in Figure 
102, assume that sum box #05 contains 02345 and sum 
box #10 contains 0001N ( negative 00015 ) . 

In a dc or dcw model statement, a blank constant 
may only define an area up to nine positions (#1 
through #9). This requirement must be met for model 
statements so that the assembler will not confuse a 
blank constant with a sum box. 



Arithmetic Expressions 

Arithmetic expressions within the math pseudo macro 
use add (+), subtract ( — ), multiply (*), and divide 
(/). Arithmetic operations are executed in the follow- 
ing order: multiplication and division, and addition 
and subtraction. If parentheses are needed to define 
the expression the @ symbol represents both the left 
and right parentheses. For example: 

(001+12-5) 20 is written @ 001+12-5 @ *20. 

Each term of an arithmetic expression is expanded to 
five characters before the math pseudo macro is placed 
on the library; any part of the expanded macro ex- 
ceeding column 75 will not be placed on the library. 
An arithmetic expression should not begin with a 
signed number. 

Arithmetic operations are executed in the operand 
field of the math pseudo macro from left to right. The 
quotient resulting from a divide operation is not half- 
adjusted, and the remainder is lost. At the end of a 
multiplication operation the five low-order positions 
are used for the result. (The high-order digits are lost.) 
An overflow is ignored. The five low-order positions of 
intermediate results are used, but the high-order posi- 
tions are lost. 

The result of the arithmetic expression is produced 
and inserted with its sign in the designated sum box 
if a sum box is specified. 

Sign Switches 

Permanent and temporary switches may store the sign 
of the result of an arithmetic expression. The first 
switch specified in the operand field of the pseudo 
macro represents a positive result (greater than zero), 
the second represents a zero result, and the third rep- 
resents a negative (less than zero) result. Consequently, 
one switch is on and the other two are off after the 
arithmetic expression has been processed. 
■' It is not necessary to specify all three switches in the 
pseudo-macro operand. However, if a switch code is 
omitted, the comma that would have followed the 

Macro Instruction 



Operation 
_!2!S lS.il IS- 



r?f07?6lFL.Dl ...FL.D.2. . 



OPERAND 
_SS 2fi 



Model Statement 



CUM 



Operand and Comment! 
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Generated Symbolic Program Entries 

ORG 02345 

ZA F LD1+0001N, FLD2 

Figure 102. Sum Boxes 
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switch code must be included unless it is the last- 
specified switch. This is the same rule that applies to 
missing parameters in a source-program macro instruc- 
tion. The same rule applies to omitted sum boxes. Any 
switch may be used to represent a sign switch. 

The library programmer: 

1. Writes math in the operation field. 

2. Writes in the operand field: 

a. the code for the sum box in which the result of 
the arithmetic expression is to be stored. 

b. the arithmetic expression 

c. the code for the switch(es) in which the sign(s) 
of the result are to be stored. 

Note: Commas must separate the sum-box 
code, the arithmetic expression, and the individ- 
ual-sign switch codes. Figure 103 shows the 
format for the math pseudo macro. 



TWff 



Operand and Comment! 



728 2930313233 3433 3637 38 394041424344 4346474849505152 533. 



.2636463 6667686 
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Figure 103. Format for math Pseudo Macro 

The macro generator: 

1. Calculates the result of the arithmetic expression 

2. Stores the result in the designated sum box 

3. Sets the sign switches. 

Example. The math pseudo macro shown in Figure 
104 multiplies parameter 07 by 401 and adds 12 to 
the result. The answer is stored in sumbox#30. If 
the result is positive, permanent switch 04 is set on; 
if the result is zero, permanent switch 06 is set on; if 
the result is negative, temporary switch 09 is set on. 

Note: Sum boxes may be used within the arith- 
metic expression in a math pseudo macro. 



37 28 29 3031 32 3334 35363738 39404142434445 4647 48 49505132 33 54 55 56 57 58 59606162636465 666768 69707172 73 74 

1 n r 



ill 



M j2(Y}0|7t»ffl4>H <>ffl >K g 



1 



MM 



Figure 104. math Pseudo Macro 



2. To cause the macro generator to skip over certain 
model statements if the logical expression is false. If 
the logical expression is true, the macro generator 
goes to the next sequential model statement. 

The library programmer: 

1. Writes bool in the operation field. 

2. May write a one-character label, the logical expres- 
sion, and the switch code in the operand field in the 
format shown in Figure 105. 



2021*2 23 24 2526 



Operand and Commen 



27282930 3132 333435 3637 38 39404 



445 46 47 48 49 5051 32 53 54 55 S6 57 58 5' 



3 64 65 666768697071 72737 
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Figure 105. Format for the bool Pseudo Macro 

Labeling 

A special one-character label permits skipping forward 
over model statements in the library routine as the 
symbolic routine is being developed. Write this one- 
character label in the first position of the operand field 
of the bool pseudo macro and also in the label posi- 
tion (column 6 of the library coding form) of the first 
model statement (or command) to be examined after 
the skip has been initiated. The macro generator will 
skip over the intervening model statements only if the 
logical expression is false. 

Omit the label to direct the macro generator not to 
skip over any model statements, but include the 
comma that would have followed the label to indicate 
that it is missing. Use any alphabetic or numeric char- 
acter as the label, but do not use a special character. 



Logical Expression 

The library programmer may use any combination of 
the three logical operations: and (*), or (+), and not 
(— ). Logic operations are executed in the following 
order: (— ), (*), and (+). If parentheses are needed 
to define the expression, the @ symbol represents both 
the right and left parentheses. The operators are de- 
fined in Figure 106. The combination of these opera- 
tors and the switches to be tested for on or off status 
make up the logical expression (Figure 107). 



BOOL — For Solving Logical Expressions 

General Description. The bool pseudo macro can be 
used: 

L. To set a permanent or temporary switch as the re- 
sult of a logical expression. 



* 


+ 


- 


1*1=1 


1+1=1 


-1=0 


1*0 = 


1+0 = 1 


-0= 1 


0*1=0 


+ 1=1 




0*0 = 


+ 0=0 





Figure 106. Table of Operators 
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Figure 107. Using the bool Pseudo Macro 



Switches 

The programmer may use either a permanent or tem- 
porary switch to store the result of a logical expression. 
If the macro generator determines that the expression 
is true, the specified switch will be set on. If it finds 
that the expression is false, the specified switch will be 
set OFF. 

The macro generator: 

1. Examines the status switches to determine whether 
the conditions specified in the logical expressions 
are satisfied. If the conditions are met, the expres- 
sion is true; if they are not, the expression is false. 

2. Sets the specified status switch to on or off to re- 
flect the true or false condition. 

3. If a false condition exists and a label appears in the 
bool operand, the macro generator skips forward to 
the command or model statement whose label posi- 
tion contains the same label character. 

To determine if a logical expression is true or 
false: 

a. Call all on switch conditions true and all off 
switch conditions false. 

b. Let 1 = true and = false. 

c. Calculate the logical value of the expression 
using the table of operators shown in Figure 106. 

If the logical value of the expression is 0, the 
expression is false. If the logical value is 1, the 
expression is true. For example, if switches 01, 
02, 03, and 04 are on, the expression: 

□01* n02 + n03* n04 is true because: 

(on * on) + (on * on) = 

(1*1) + (1*1)= 
1 + 1=1 

Examples. Figure 107 shows how the bool pseudo 
macro can be used. The bool entry states: 

1. If temporary switches 01 and 02 are on, the state- 
ment is true. Therefore, set temporary switch 15 on. 

2. However, if either temporary switch 01 or 02 is off, 
the statement is false. Therefore, set temporary 
switch 15 off and skip to statement 004. 



The examples shown in Figure 108 state: 

1. If both temporary switches 01 and 02 or both tem- 
porary switches 03 and 04 are on, the statement is 
true. Therefore, set temporary switch 15 on. 

2. However, if either temporary switch 01 or 02 and 
either temporary switch 03 and 04 are off, the state- 
ment is false. Therefore, set temporary switch 15 
off and slap to the statement whose label is L. 
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Figure 108. bool Pseudo Macro 



Figure 109 is a table showing all conditions that- 
will cause the bool statement shown in Figure 108 to 
be true. 

SWITCHES 



01 


* 


02 


+ 


03 


* 


04 


LOGICAL 
VALUE 


ON 

1 


* 


ON 

1 


+ 


OFF 



* 


OFF 



1 


OFF 



* 


OFF 



+ 


ON 
1 


• 


ON 

1 


1 


ON 

1 


* 


ON 
1 


+ 


ON 

1 


* 


ON 
1 


= 1 


ON 

1 


* 


ON 
1 


+ 


ON 

1 


* 


OFF 



1 


OFF 



* 


ON 
1 


+ 


ON 

1 


* 


ON 
1 


= 1 


ON 

1 


* 


ON 
1 


+ 


OFF 



* 


ON 
1 


= l 


ON 

1 


* 


OFF 



+ 


ON 

1 


* 


ON 
1 


= j 



Figure 109. True Conditions 

Figure 110 is a table showing all conditions that 
will cause the bool statement shown in Figure 108 to 
be false. 

MEND — End of Routine 

General Description. Use this pseudo macro to signal 
the processor that no more model statements in the 
library routine are to be processed. 

The library programmer: 

1. Writes mend in the operation field. 

2. Leaves the operand field blank. 

Note: The library programmer may use a bool 
pseudo macro to direct the assembler to skip over a 
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SWITCHES 



01 


* 


02 


+ 


03 


* 


04 




LOGICAL 
VALUE 


OFF 



* 


OFF 



+ 


OFF 



* 


OFF 



= 





ON 
1 


* 


OFF 



+ 


OFF 



* 


OFF 



= 





OFF 



* 


ON 
1 


+ 


OFF 



• 


OFF 



= 





OFF 



* 


OFF 



+ 


ON 
1 


* 


OFF 



= 





OFF 



* 


OFF 



+ 


OFF 



* 


ON 

1 


= 





OFF 



* 


ON 
1 


+ 


OFF 



• 


ON 

1 


= 





ON 
1 


* 


OFF 



+ 


ON 
1 


* 


OFF 



= 





OFF 



* 


ON 
1 


+ 


ON 
1 


* 


OFF 



= 





ON 
1 


* 


OFF 



+ 


OFF 



* 


ON 
1 


= 






Figure 110. False Conditions 



mend pseudo macro that appears within the library 
routine, if conditions indicate that more library 
statements must be processed. 

The macro generator: Stops processing the source-pro- 
gram macro instruction when it encounters a mend 
statement. 

Example. Figure 111 shows a mend statement. 



2. Writes the name of the library routine in the label 
field. 

The following may not be used as names for 
library routines: diocs, dtf, file, get, merge, put, 
and sort. 

3. To insert an entire library routine, leave the oper- 
and field blank. 

To insert model statements, write the sequence 
number of the statement after which the insertion 
is to be made. 

To substitute model statements, write the se- 
quence numbers, separated by a comma, of the first 
and last model statements to be deleted. 

Note: The sequence numbers of model state- 
ments are given in the alter column of the library 
listing. 

The librarian: 

1. Inserts the new model statements, or 

2. Inserts the new library routine. 

Result. The library contains the new or modified 
library routine. 

During the macro-generator phases of Autocoder, 
the header label is matched with the macro name 
in a source-program macro instruction. The model 
statements following the header label in the library 
are used to assemble the symbolic routine that will 
be incorporated in the object program. 

Examples. Figure 112 is an inser statement that will 
cause a library routine named check to be inserted 
into the disk-storage library. 
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Figure 111. mend Pseudo Macro 



Librarian Control Operations 

The inser and delet statements are used during the 
librarian phase of Autocoder. 

INSER - Insert 

General Description. An inser statement identifies the 
library routine. This identification precedes the li- 
brary routine in disk storage. The programmer can 
use this statement to insert whole library routines 
or part of a library routine. 

The library programmer: 

1. Writes inser in the operation field of the standard 
Autocoder coding sheet. 



Label Operation 



JCUEC/C i \/MS£jA 



OPERAND 
_S2 ii 39. 



Figure 112. Inserting an Entire Library Routine 

Figure 113 is an inser statement that causes the 
first model statement that is in the library routine 
to be deleted, and the model statement shown to 
be inserted into its place. 

Autocoder Statement 



Label 



CHECK. \ 



Operation 
' 2S 



INSER 



OPERAND 
_52 32 S2 ii 50 



1.4. 



Model Statement 



l 


Label 


Operation 


Operand and Comments 
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Figure 113. Substituting One Model Statement for Another 
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Autocoder Statement 



Label 



Operation 



\ CHECK 



tfiSmiyZ 



Model Statement 



I 


Label 


Operation 


Operand and Comments 
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Figure 114. Substituting Multiple Model Statements 



Figure 114 is an inser statement that causes model 
statements 1 and 2 to be deleted, and the model 
statements shown to be inserted into their places. 



To delete more than one model statement, write 
the sequence numbers, separated by a comma, of 
the first and last statements to be deleted. 

Note: The sequence numbers of model statements 
are given in the alter column of the library listing. 

The librarian: 

1. Deletes the specified model statements, or 

2. Deletes the entire routine, if the operand field is 
blank. 

Result. The library is modified according to the user's 
specifications. 

Examples. Figure 115 is a delet statement that causes 
the entire check routine to be removed from the 
library. 



Label 

6 IS 


Operation 
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OPERAND 

45 SO 


CAeac i . , , 


D.£.i..B7 





Figure 115. Deleting an Entire Library Routine 



DELET - Delete 

General Description. The programmer may use this 
statement to delete a library routine, or parts of a 
library routine, from the disk-storage library. 

The library programmer: 

1. Writes delet in the operation field of the standard 
Autocoder coding sheet. 

2. Writes the name of the library routine in the label 
field. 

3. To delete an entire library routine, leave the oper- 
and field blank. 

To delete one model statement, write the se- 
quence number of the statement in the operand 
field. 



Figure 116 is a delet statement that causes the 
first model statement to be deleted from the check 
routine. 



Lobel 



l£/ fc , C & 



Operation 
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Figure 116. Deleting a Single Model Statement 

Figure 117 is a delet statement that causes model 
statements 2, 3, 4, and 5 to be deleted from the 
check routine. 



Label 



P, fl£ , Cr Ar. 



Operation 
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Figure 1 17. Deleting Multiple Model Statements 
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Appendix 



Declarative and Assembler-Control Statements 

Figure 118 lists all the declarative and assembler- 
control mnemonic operation codes that are valid for 
the Disk Autocoder language. 



Imperative Statements 

Figure 119 is an imperative-statement reference chart 
that lists all the valid-mnemonic imperative-operation 
codes. The information given for each mnemonic 
listed is: 

1. The description of the mnemonic. 

2. The machine-language operation code. 

3. The operand sequence. This entry represents the 
valid set of operands to be used with the mnemonic. 
Deviations from the specified operand sequences 
will be diagnosed. 

The following symbols are used to describe the 
operand sequence. 

Symbols Meaning 

RD Declared field — an actual, symbolic, or asterisk 
address, or an area-defining literal. Address-adjust- 
ment and indexing are permitted. 

D Constant or declared field — an actual, symbolic, 
or asterisk address, or a literal. Address-adjustment 
and/or indexing are permitted. 



DECLARATIVE OPERATIONS 


Mnemonic Description 


DA Define Area 




DC Define Constant (No Word Mark) 




DCW Define Constant With Word Mark 




DS Define Symbol 




DSA Define Symbol Address 




EQU Equate 




ASSEMBLER CONTROL OPERATIONS 


Mnemonic Description 


Mnemonic 


Description 


CTL Control 


ULST 


Stop Listing 


END End 


ORG 


Origin 


ENT Enter New 


XFR 


Transfer 


Coding Mode 


SFX 


Suffix 


EX Execute 


JOB 


Job 


LTORG Literal Origin 


INSER 


Insert 


LIST Resume Listing 


DELET 


Delete 


SPCE Space n Lines 







Figure 118. Declarative and Assembler Control Operations 



Symbols Meaning 

XC X-control field — address of a unit, such as %U1 
used to address tape-unit 1. 

Address-adjustment and/or indexing are not per- 
mitted. 

n Single numeric character. 

Address-adjustment and/or indexing are not per- 
mitted. 

S Symbolic address. Address-adjustment and/or in- 

dexing are not permitted. 

d d-character — used to modify an operation code. 

, Operand separator. 

/ Optional operand separator. For example, n/XC/S 

means that either a single numeric character or an 
X-control field, or a symbolic address, may be used 
for the operand. 

4. The code that indicates whether deletion of one or 
both operands is permitted. 

Code Meaning 

2 Both operands deleted 

1 or 2 Either the last or both operands deleted 

None No operands deleted 

Autocoder diagnostic phases detect an invalid num- 
ber of operands. For example, if a bwz instruction 
contained one operand and a d-character, the diag- 
nostic message # operands would be printed. 

Note: The programmer should know the effects of 
his instructions on the status of the A- and B-address 
registers in order to determine whether deletion of 
operands is practical in specific cases. 

Most single-address instructions (Op code and an 
A-address) cause the A-address to be inserted in 
both the A- and B-address registers. However, 

MOVE, LOAD, and STORE B-ADDRESS REGISTER (Op Codes 

m, l, and h) do not disturb the B-address register, , 
and therefore permit the programmer to use the 
previous contents of that register as part of the in- 
struction. 

All no-address instructions (Op code only) use the 
previous contents of the A- and B-address registers. 

The contents of the B-address register after a 
branch instruction depend on the type of branch, 
the success of the branch, and the presence or ab- 
sence of the indexing feature. 

5. The X-control field, if required. 

6. The d-character, if required. Figures 120 and 121 
list the d-characters for Control Carriage (cc) and 
Select Stacker (ss) mnemonics. 

7. The object systems or devices on which the instruc- 
tion can be executed. 
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Mnemonic 


Description 


Op 
Code 


Operand 
Sequence 


Operand 
Deletion 


X-Control 
Field 


d- 
Character 


Object System 
or Device 


ARITHMETIC OPERATIONS 


A 
S 
ZA 


Add 

Subtract 
Zero and Add 


A 
S 


D,RD 
D,RD 
D,RD 


1 or 2 
1 or 2 
1 or 2 






all systems 
all systems 
all systems 


ZS 

D 
M 


Zero and Subtract 

Divide 

Multiply 


% 
@ 


D,RD 
D,RD 
D,RD 


1 or 2 
None 
None 






all systems 
all systems* 
all systems* 




DATA 


CONTROL OPERATIONS 




MBC 
MBD 
MCE 


Move and Binary Code 
Move and Binary Decode 
Move Characters and Edit 


M 
M 
E 


D,RD 
D,RD 
D,RD 


None 
None 
1 or 2 




B 
A 


1401*, 1460* 
1401*, 1460* 
all systems 


MCS 
MIZ 
MLC 


Move Characters and Suppress Zeros 

Move and Insert Zeros 

Move Characters to Word Mark 


Z 
X 
M 


D,RD 
D,RD 
D,RD 


1 or 2 
None 
1 or 2 






all systems 

1401*, 1460*, 1440* 

all systems 


MCW 
MLCWA / 
LCA \ 


Move Characters to Word Mark 
Move Characters and Word Marks 
to Word Mark in A-field 


M 
L 
L 


D,RD 
D,RD 
D,RD 


1 or 2 
1 or 2 
1 or 2 






1401, 1460 
all systems 
1401, 1460 


MLNS ) 
MN j" 


Move Numeric portion of Single Character 


D 
D 


D,RD 
D,RD 


1 or 2 
1 or 2 






all systems 
1401, 1460 


MLZS I 
MZ \ 


Move Single Zone 


Y 
Y 


D,RD 
D,RD 


1 or 2 
1 or 2 






all systems 
1401, 1460 


MRCM l 
MCM ) 


Move Characters to Record Mark 
or Group Mark-Word Mark 


P 
P 


D,RD 
D,RD 


1 or 2 
1 or 2 






1401*, 1460, 1440 
1401*, 1460 


MRCWG 


Move Characters and Word Marks to Group 
Mark-Word Mark in A-field 


P 


D,RD 


1 or 2 




> 


1440*, 1460 Mod 3* 




L 


OGIC 


OPERATIONS 






B 

BAV 

BBE 


Branch Unconditional 

Branch on Arithmetic Overflow 

Branch if Bit Equal 


B 
B 
W 


RD 
RD 
RD,D,d 


None 

None 

2 




Z 
d** 


all systems 
all systems 
all systems* 


BCE 
BCV 
BC9 


Branch if Character Equal 
Branch on Carriage Overflow (12) 
Branch on Carriage Channel 9 


B 
B 
B 


RD,D,d 

RD 

RD 


2 
None 
None 




d** 

@ 
9 


all systems 
all systems 
all systems 


BE 

BEF 

BER 


Branch on Equal Compare (B = A) 
Branch on End of File or End of Reel 
Branch on Tape Transmission Error 


B 
B 
B 


RD 
RD 
RD 


None 
None 
None 




S 
K 
L 


1401*, 1460, 1440 
1401*, 1460*, 1440 
1401*, 1460*, 1440 


BH 

BIN 

BIN 


Branch on High Compare (B > A) 
Branch if any Disk Drive Error Condition 
Branch if Access Inoperable 


B 
B 
B 


RD 

RD,d 

RD,d 


None 
None 
None 




U 
y** 

N** 


1401*, 1460, 1440 
1401*, 1460*, 1440 
1401*, 1460*, 1440 


BIN 
BIN 
BIN 


Branch if Disk Error 

Branch if Wrong-Length Record (Disk) 

Branch if Unequal Address Compare (Disk) 


B 
B 
B 


RD,d 
RD,d 
RD,d 


None 
None 
None 




y** 

w** 

X** 


1401*, 1460*, 1440 
1401*, 1460*, 1440 
1401*, 1460*, 1440 


BIN 
BIN 
BIN 


Branch if Reader Error I/O Check Stop Switch Off 
Branch if Punch Error I/O Check Stop Switch Off 
Branch if Printer Error I/O Check Stop Switch Off 


B 
B 
B 


RD,d 
RD,d 
RD,d 


None 
None 
None 




1** 

x ** 


all systems 
all systems 
all systems 


BIN 
BIN 
BIN 


Branch if Check Stop Switch Off 
Branch if Access Busy 
Inquiry Clear 


B 
B 
B 


RD,d 
RD,d 
RD,d 


None 
None 
None 




%** 
* ** 


all systems 
all systems 
all systems* 


BIN 
BIN 
BIN 


Inquiry Request 
Reader Busy 
Punch Busy 


B 
B 
B 


RD,d 
RD,d 
RD,d 


None 
None 
None 




Q** 
H** 


all systems 
1401, 1460 
1401, 1460 


BIN 

BL 

BLC 


Tape or Input-Output Busy 
Branch on Low Compare (B < A) 
Branch on Last Card (Sense Switch A) 


B 
B 
B 


RD,d 

RD 

RD 


None 
None 
None 




j** 

T 

A 


1401*, 1460* 
1401*, 1460, 1440 
all systems 



* Special Feature 
** d-Character must be placed in operand when coding in Autocoder. 

t (See Figure 120) 
ft (See Figure 121) 
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Mnemonic 


Description 


Op 
Code 


Operand 
Sequence 


Operand 
Deletion 


X-Control 
Field 


d- 
Character 


Object System 
or Device 


LOGIC OPERATIONS (CONT.) 


BLC2 

BM 

BPCB 


Branch on Last Card (Reader Unit 2) 
Branch on Minus (11 -Zone) 
Branch Printer Carriage Busy 


B 
V 
B 


RD 

RD,D 

RD 


None 

2 
None 




& 
K 
R 


1440 

all systems 

1401*, 1460*, 1440 


BPB 
BSS 


Branch Printer Busy 

Branch on Sense Switch (B-G) 


B 
B 


RD 
RD,d 


None 
None 




P 

(B-G)** 


1401 *,1 460*, 1440 
all systems* 


BSS 

BU 

BW 


Branch on Sense Switch A 

Branch on Unequal Compare (B ^ A) 

Branch on Word Mark 


B 
B 
V 


RD,d 

RD 

RD,D 


None 

None 

2 




A** 

/ 

1 


all systems 
all systems 
all systems 


BWZ 
BWZ 
BWZ 


Branch on No Zone (No A- or B-Bit) 
Branch on 12-Zone (AB-bits) 
Branch on 1 1-Zone (B-bit, no A-bit) 


V 
V 
V 


RD,D,d 
RD,D,d 
RD,D,d 


2 
2 
2 




2** 
B** 
K** 


all systems 
all systems 
all systems 


BWZ 
BWZ 
BWZ 


Branch on O-Zone (A-bit, no B-bit) 

Branch on either a Word Mark or No Zone 

Branch on either a Word Mark or 12-Zone 


V 
V 
V 


RD,D,d 
RD,D,d 
RD,D,d 


2 
2 
2 




s** 

3** 

c** 


all systems 
all systems 
all systems 


BWZ 
BWZ 

C 


Branch on either a Word Mark or 11 -Zone 
Branch on either a Word Mark or O-Zone 
Compare 


V 
V 
C 


RD,D,d 
RD,D,d 
D,D 


2 
2 

1 or 2 




i ** 

j** 


all systems 
all systems 
all systems 


MISCELLANEOUS OPERATIONS 


CC 
CCB 
CS 
CS 


Carriage Control 

Carriage Control and Branch 

Clear Storage 

Clear Storage and Branch 


F 
F 

/ 
/ 


d 

RD,d 
RD 
RD,RD 


None 
None 
1 or 2 
1 or 2 




d**f 
d**f 


all systems 
1401, 1460 
all systems 
all systems 


CW 

H 

MA 


Clear Word Mark 

Halt 

Modify Address 


□ 

# 


RD,RD 

D,D 

D,RD 


1 or 2 
1 or 2 
1 or 2 






all systems 
all systems 
all systems* 


NOP 
SAR 
SBR 


No Operation 

Store A-Address Register 

Store B-Address Register 


N 
Q 
H 


XC/D,D,d 

RD,D 

RD,D 


1 or 2 
1 or 2 
1 or 2 




** 


all systems 
all systems* 
all systems* 


SS 

SSB 

SS 


Select Stacker 

Select Stacker and Branch 

Overlap On 


K 
K 
K 


d 

RD,d 

d 


None 
None 
None 




d**ft 

d**ft 
$** 


all systems 
1401, 1460 
1401*, 1460* 


SSB 

SS 

SSB 


Overlap On and Branch 

Overlap Off 

Overlap Off and Branch 


K 
K 
K 


RD,d 

d 

RD,d 


None 
None 
None 




$** 
. ** 
. ** 


1401*, 1460* 
1401*, 1460* 
1401*, 1460* 


SW 

TR 

TRW 


Set Word Mark 

Translate 

Translate with Word Marks 


T 
T 


RD,RD 

D,RD 

D,RD 


1 or 2 
None 
None 




> 


all systems 
1440*, 1460* 
1440*, 1460* 


MAGNETIC TAPE OPERATIONS 


BSP 

RT 

RTB 


Backspace Tape 

Read Tape 

Read Tape Binary 


U 

M 
M 


n/XC/S 

n/XC/S,RD 

n/XC/S,RD 


None 
None 
None 


%Un 
%Un 
%Bn 


B 
R 
R 


all systems 
all systems 
all systems 


RTW 
RWD 
RWU 


Read Tape with Word Marks 

Rewind Tape 

Rewind and Unload Tape 


L 
U 
U 


n/XC/S,RD 

n/XC/S 
n/XC/S 


None 
None 
None 


%Un 
%Un 
%Un 


R 
R 
U 


all systems 
all systems 
all systems 


SKP 
WT 
WTB 


Skip and Blank Tape 
Write Tape 
Write Tape Binary 


U 

M 
M 


n/XC/S 

n/XC/S,RD 

n/XC/S,RD 


None 
None 
None 


%Un 
%Un 

%Bn 


E 

W 

W 


all systems 
all systems 
all systems 


WTM 
WTW 


Write Tape Mark 

Write Tape with Word Marks 


U 
L 


n/XC/S 
n/XC/S,RD 


None 
None 


%Un 
%Un 


M 
W 


all systems 
all systems 


^Note. For t 


ape operations in the overlap mode (1401*, 1460'' 


), the operand sequen 


ce is XC/S, 


RD. 






The ) 


(-control field must begin with an @ symbol in 


stead of a % symbol. 











* Special Feature 
** d-Character must be placed in operand when coding in Autocoder. 

f (See Figure 120) 
ft (See Figure 121) 

Figure 119. Imperative Operations (Part 2 of 4) 
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Mnemonic 


Description 


Op 
Code 


Operand 
Sequence 


Operand 
Deletion 


X-Control 
Field 


d- 
Character 


Object System 
or Device 


I/O DEVICE OPERATIONS 


R 
R 
RCB 


Read a Card 
Read a Card 
Read Column Binary (Card Image) 


1 

M 

1 


RD 

n/XC/S,RD 
RD 


None 
None 
None 


%Gn 


R 
C 


1402 
1442 
1402* 


RCB 

P 

P 


Read Column Binary (Card Image) 

Punch a Card 

Punch a Card and Feed 


M 
4 
M 


n/XC/S,RD 

RD 

n/XC/S,RD 


None 
None 
None 


%Gn 
%Gn 


R 
G 


1442* 

1402 

1442 


PCB 
PCB 
PS 


Punch Column Binary (Card Image) 

Punch Column Binary and Feed (Card Image) 

Punch a Card and Stop 


4 
M 
M 


RD 

n/XC/S,RD 

n/XC/S,RD 


None 
None 
None 


%Gn 
%Gn 


C 
G 
P 


1402* 
1442* 
1442 


W 
W 
WM 


Write a Line 
Write a Line 
Write Word Marks 


2 
M 
2 


RD 
RD 
RD 


None 
None 
None 


%Y1 


W 

n 


1403, 1404 
1443, 1445*** 
1403 


WS 
WR 
RP 


Write and Suppress Space 
Write and Read 
Read and Punch 


M 
3 
5 


RD 
RD 
RD 


None 
None 
None 


%Y1 


s 


1443, 1445*** 

1402 

1402 


RF 

WP 

WRF 


Read Punch Feed 
Write and Punch 
Write and Read Punch Feed 


4 
6 
6 


RD 
RD 
RD 


None 
None 
None 




R 
R 


1402* 

1402 

1402* 


WRP 

SRF 

SPF 


Write, Read, and Punch 
Start Read Feed 
Start Punch Feed 


7 
8 
9 


RD 

No operands 
No operands 


None 






1402 

1402* 

1402* 


WCP 
RCP 
WCPW 


Write Console Printer 
Read Console Printer 
Write Console Printer with Word Marks 


M 
M 
L 


RD 
RD 
RD 


None 
None 
None 


%T0 
%T0 
%T0 


W 

R 

W 


1407, 1447 
1407, 1447 
1407, 1447 


RCPW 

PSK 

LU 


Read Console Printer with Word Marks 
Punch Skip 
Load Unit 


L 

M 
L 


RD 

n/XC/S,RD 

XC/S,RD,d 


None 
None 
None 


%T0 
%Gn 


R 

C 
d** 


1407, 1447 

1442 

all devices 


MU 
CU 


Move Unit 
Control Unit 


M 
U 


XC/S,RD,d 
XC/S,d 


None 
None 




d** 
d** 


all devices 
all devices 


Note. If W 


U and LU are used for overlap operations (1401*, 


1460*) 


with magnetic 


tape, paper tape, or < 


:har- 




acte 


r reader, the X-control field must begin with an 


@ sym 


sol instead of 


a % syn 


ibol. 










DISK O 


PERATIONS 










RD 

RDCO 

RDCOW 


Read Disk Sector(s) 
Read Disk with Sector Count Overlay 
Read Disk with Sector Count Overlay 
with Word Marks 


M 
M 
L 


RD 
RD 
RD 


None 
None 
None 


%F1 

%F5 
%F5 


R 
R 
R 


1405, 1311, 1301 
1311, 1301 
1311, 1301 


RDT 
RDT 
RDTA 


Read Disk Track Sectors with Addresses 

Read Disk Full Track 

Read Disk Track Record with Address 


M. 

M 

M 


RD 
RD 
RD 


None 
None 
None 


%F6 

%F2 

%F@ 


R 
R 
R 


1311, 1301 
1405 
1311, 1301 


RDTAW 
RDTR 


Read Disk Track Record with Address 

and Word Marks 
Read Disk Track Record 


L 
M 


RD 
RD 


None 
None 


%F@ 
%F2 


R 
R 


1311, 1301 
1311, 1301 


RDTRW 
RDTW 


Read Disk Track Record with Word Marks 
Read Disk Track Sectors with Addresses 
and Word Marks 


L 
L 


RD 
RD 


None 
None 


%F2 
%F6 


R 
R 


1311, 1301 
1311, 1301 


RDTW 

RDW 

SD 


Read Disk Full Track with Word Marks 
Read Disk Sector(s) with Word Marks 
Seek Disk 


L 
L 

M 


RD 
RD 
RD 


None 
None 
None 


%F2 
%F1 
%F0 


R 
R 
R 


1405 

1405, 1311, 1301 

1405, 1311, 1301 


SDE 

SDEW 

SDH 


Scan Disk Equal 

Scan Disk Equal with Word Marks 

Scan Disk High, Equal 


M 
L 
M 


RD 
RD 
RD 


None 
None 
None 


%F8 
%F8 
%F9 


W 
W 
W 


1311, 1301* 
1311, 1301* 
1311, 1301* 



* Special Feature. 
**d-Charac?er must be placed in operand when coding in Autocoder. 
***1445 on 1440/1460 Systems only. 

f(See Figure 120) 
tt(See Figure 121) 



Figure 119. Imperative Operations (Part 3 of 4) 
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Mnemonic 


Description 


Op 
Code 


Operand 
Sequence 


Operand 
Deletion 


X-Control 
Field 


d- 
Character 


Object System 
or Device 


DISK OPERATIONS (CONT.) 


SDHW 

SDL 

SDLW 


Scan Disk High, Equal with Word Marks 

Scan Disk Low, Equal 

Scan Disk Low, Equal with Word Marks 


L 
M 
L 


RD 
RD 
RD 


None 
None 
None 


%F9 
%F7 
%F7 


W 
W 
W 


1311, 1301 
1311, 1301 
1311, 1301 


WD 

WDC 

WDCO 


Write Disk Sector(s) 

Write Disk Check 

Write Disk with Sector Count Overlay 


M 
M 
M 


RD 
RD 
RD 


None 
None 
None 


%F1 

%F3 
%F5 


W 
W 
W 


1405, 1311, 1301 
1405, 1311, 1301 
1311, 1301 


WDCOW 
WDCW 


Write Disk with Sector Count Overlay 

with Word Marks 
Write Disk Check with Word Marks 


L 
L 


RD 
RD 


None 
None 


%F5 
%F3 


W 
W 


1311, 1301 
1405, 1311, 1301 


WDT 
WDT 
WDTA 


Write Disk Track Sectors with Addresses 

Write Disk Full Track 

Write Disk Track Record with Address 


M 
M 
M 


RD 
RD 
RD 


None 
None 
None 


%F6 
%F2 
%F@ 


W 
W 
W 


1311, 1301 
1405 
1311, 1301 


WDTAW 
WDTR 


Write Disk Track Record with Address 

and Word Marks 
Write Disk Track Record 


L 

M 


RD 
RD 


None 
None 


%F@ 
%F2 


W 
W 


1311, 1301 
1311, 1301 


WDTRW 
WDTW 


Write Disk Track Record with Word Marks 
Write Disk Track Sectors with Addresses 
and Word Marks 


L 
L 


RD 
RD 


None 
None 


%F2 
%F6 


W 
W 


1311, 1301 
1311, 1301 


WDTW 
WDW 


Write Disk Full Track with Word Marks 
Write Disk Sector(s) with Word Marks 


L 
L 


RD 
RD 


None 
None 


%F2 
%F1 


W 
W 


1405 

1405, 1311, 1301 



* Special Feature 
** d-Character must be placed in operand when coding in Autocoder. 

f (See Figure 120) 
ft (See Figure 121) 

Figure 119. Imperative Operations (Part 4 of 4) 



d Immediate skip to 




d Skip after print to 


1 Channel 1 

2 Channel 2 

3 Channel 3 

4 Channel 4 

5 Channel 5 

6 Channel 6 

7 Channel 7 

8 Channel 8 

9 Channel 9 
Channel 10 
t Channel 11 
@ Channel 12 




A Channel 1 
B Channel 2 
C Channel 3 
D Channel 4 
E Channel 5 
F Channel 6 
G Channel 7 
H Channel 8 
1 Channel 9 
? Channel 10 
Channel 1 1 
n Channel 12 


d Immediate space 




d After print-space 


J 1 space 
K 2 spaces 
L 3 spaces 




/ 1 space 
S 2 spaces 
T 3 spaces 



Select Stacker (1402) 


d 


Feed 




Stacker Pocket 


1 
2 
4 
8 


Read 
Read 
Punch 
Punch 




1 

8/2 
4 
8/2 


Select Stacker (1442, 


1444) 






Unit (Device) 


d 


Feed 


Stacker Pocket 


1 (1442) 

2 (1442) 

3 (1444) 


2 

# 


Read/Punch 
Read/Punch 
Punch 


2 
2 
2 



Figure 120. Control Carriage d-Characters 



Figure 121. Select Stacker d-Characters 
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Index 



Actual Address Operands 9 

add — Add Macro 39 

Address Adjustment 12, 14 

Address-Adjustment and Indexing (Library Routines) 44 

Address-Constant Literals 10, 14 

Address Constants 17 

Address Operands 9 

Addresses, Symbolic 9 

Alphameric Constants 17 

Alphameric Literals 10 

Area-Defining Literals 12 

Area-Definition Statements 5, 6 

Arithmetic Expressions 46 

Arithmetic Macros 39 

Assembler Control Statements 5, 6, 24, 51 

Assembler Program 5, 6 

Asterisk Address Operands 9 

Autocoder Programming System 5 

Basic Autocoder 29 

Blank Constants 17 

Blank Operands 10 

BOOL — For Solving Logical Expressions 47 

Branch Instructions 23 

call — Call Macro 31, 34 

chain Macro 36 

Closed Routine 34 

Coding Sheet 6 

Comments 8 

compr — Compare Macro 38 

Condition Codes 33, 43 

Constant Operands 14 

Constants 6, 16 

Core-Storage Address Operands 9 

ctl — Control Card 24 

cu — Control Unit 23 

d-Character 8, 22 

da — Define Area 18 

da Header 18 

dc — Define Constant (No Word Mark) 17 

dcw — Define Constant with Word Mark 16 

Declarative Statements 6, 16, 51 

delet — Delete Statement 50 

Diagnostics 6 

divid — Divide Macro 41 

ds — Define Symbol 18 

dsa — Define Symbol Address 18 

end — End Assembly Card 28, 34 

ent — Enter New Coding Mode 29 

equ — Equate 21 

Equivalent Address 8 

ex — Execute 27, 34, 44 

Flexible Library Routines 31 

Group-Mark with a Word-Mark (da) 19 

Identification 8 

Imperative Statements 6, 22, 51 

tncld Macro 31, 34 



incld Processing 34 

incld Routines 31, 44 

Indexing 13, 14 

Indexing (da) 18, 19 

Inflexible Library Routines 31, 34, 44 

Input-Output Operands 14 

inser — Insert Statement 49 

Instruction Statements 22 

job — Job Card , 24 

Labels 7 

Labeling (Model Statements) 43 

Labeling (bool) 47 

Language, Machine 5 

Language, Symbolic 5 

ldrcl Macro 38 

Librarian 31, 42 

Librarian Control Operation 49 

Library Coding Form 32 

Library Programmer 31, 42 

Library Routine 31, 42 

Line Number 7 

Linkage Macros 38 

list — Start Listing 29 

Literal Origin (ltorg) 27, 34, 44 

Literals 5, 10, 44 

Logical Expression 47 

loop — Loop Macro 37 

ltorg — Literal Origin 27, 34, 44 

lu — Load Unit 23 

ma Macro — Modify Address 36 

Machine language 5 

Machine Language Coding 24 

Machine Requirements 5 

Macro Generator 31, 42 

Macro Instruction 5, 6, 31 

Macro Name 31 

Macro Operation 6, 33 

Macro Processing 33 

Macro System 31 

math — For Solving Algebraic Expressions 46 

mend — End of Routine 48 

mltpy — Multiply Macro 40 

Mnemonic Operation Codes 5, 6, 8, 22, 51 

Model Statement 31, 32, 42 

Modify Address Feature 25, 36 

mu — Move Unit 23 

Numeric Constants 16 

Numeric Literals 10 

Object Program 5, 6 

Open Routines 33 

Operands 8, 9, 22, 44 

Operation Codes 5, 6, 8, 43 

org — Origin 25 

Output Listing 24, 29 

Page Number 7 

Parameters 31, 32, 33, 42 

Permanent Switches 45 
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Program Overlay 7 

Programming with Autocoder 6 

Pseudo Macro Instructions 31, 33, 45 

Record Marks (da) 19 

sfx — Suffix 28 

Sign Switches 46 

skipn — Skip to Next Page 29 

Source Program 6 

spce — Space n Lines 29 

Statement Descriptions 16 

Stop Listing (ulst) 29 

sun — Subtract Macro 40 

Substitution Codes 33, 42 

Subsequent DA Entries 19 

Suffix (sfx) 28 

Sum Boxes 46 

Switches 39, 45 

Symbolic Address Operands 5, 9 

Symbolic Addressing (Model Statements) 44 

Symbolic Indexing 14 

Symbolic Language 5 

Symbolic Programming Systems (SPS) 29 

Symbolic Routine (Macro System) 31 

syscl Macro 38 

System Control Program 6 

Temporary Switches 45 

Transfer (xfr) 28 

ulst — Stop Listing 29 

xfr — Transfer 28 
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